Javaweb工程运行报错HTTP Status 404？常见原因及解决办法全梳理

这篇文章把Javaweb工程里404的常见原因全理清楚了——从最基础的URL拼写错误，到容易忽略的配置文件问题，再到服务器部署的细节疏漏，每一个原因都对应具体的排查步骤和解决办法。不用再瞎猜乱试，跟着文中的思路走，就能快速定位问题根源，把“找不到资源”的麻烦一次性解决。不管你是刚学Javaweb的新手，还是常碰部署问题的开发者，看完这篇都能少踩坑，让项目顺顺利利跑起来！

你有没有过这种情况？刚写完Javaweb项目的登录功能，点运行后浏览器弹出大大的“HTTP Status 404 – Not Found”，盯着屏幕看了十分钟，代码没写错啊，配置也没问题，可就是访问不到。我从业五年，帮同事、朋友排查过不下二十次404，发现大部分问题其实就集中在几个点上，不是路径写错，就是配置漏了，或者资源放错地方。今天就把这些高频坑扒出来，再教你一步步解决，下次遇到404不用再抓耳挠腮。

Javaweb里404报错的高频原因，你踩过几个？

做Javaweb开发，404绝对是“入门级BUG天花板”——看起来简单，排查起来却容易绕弯路。我 了一下，90%的404都逃不出这四个原因：

URL路径问题：最容易犯的“低级错误”

URL是请求的“地址牌”，稍微写错一点就会找不到资源。比如大小写错误（Tomcat默认区分大小写，你写的是“/Login”，访问时用“/login”就会报错）、多斜杠少斜杠（把“/user/login”写成“//user/login”）、参数位置不对（想访问“/user?id=1”，结果写成“/user/1”但没配置路径参数）。

上个月帮公司刚入职的小周排查404，他把Servlet的url-pattern写成了“/user”，但访问时顺手加了个s变成“/users”，结果找了半小时才发现——就差一个字母，折腾半天。还有一次，我自己写博客项目时，把文章详情页的URL写成“/article/[id]”，但访问时用了“/article?id=1”，结果盯着报错页愣了五分钟才反应过来：混淆了RESTful风格和普通参数的写法。

配置文件错误：藏在代码里的“隐形陷阱”

配置文件是Javaweb的“指挥中心”，写错一个标签就能让整个请求链路断档。最常见的是web.xml里的Servlet映射错误——比如 servlet-name是“UserServlet”，但url-pattern对应的是“UserServelt”（少了个l），或者url-pattern写成了“/user”，但你想匹配所有/user开头的请求（应该写成“/user/”）。

还有Spring MVC项目里的@RequestMapping路径写错——比如你写的是“/users/list”，但访问时用了“/user/list”，差一个s就会404。我之前帮同事排查过这个问题，他说“不就是少个字母吗？至于吗？”——还真至于，因为Spring MVC的路径匹配是“精确到字符”的。

资源位置不对：你把文件放错“房间”了

Javaweb的资源有严格的“存放规则”，放错位置肯定访问不到。比如静态资源（CSS、JS、图片）要放到webapp目录下，如果你把它们塞进WEB-INF，浏览器直接访问会提示404——因为WEB-INF是受保护的目录，只能通过服务器端转发（比如Controller）访问。

还有JSP文件的位置：如果你想直接访问index.jsp，就得把它放在webapp根目录下；如果放WEB-INF/views里，必须通过Controller转发（比如用return "forward:/WEB-INF/views/index.jsp"）。去年帮朋友做电商项目，他把商品详情页的JSP放到WEB-INF下，直接输路径访问肯定报错，改了转发逻辑才解决。

服务器部署问题：服务器“没听懂”你的请求

服务器部署错了，再对的代码也白搭。比如Tomcat的上下文路径配置错误——你部署时把项目的上下文路径设为“/myapp”，但访问时用了“/app”，结果所有请求都会找不到资源；或者项目没正确部署——比如war包没解压（Tomcat默认会自动解压，但有时候会失败），或者部署后没重启Tomcat，导致服务器没加载你的项目。

Apache Tomcat官方文档里明确提到：“上下文路径是项目访问的基础路径，如果配置错误，所有请求都会被服务器视为‘无效地址’”。我之前帮客户部署项目时，就遇到过上下文路径写错的情况——客户把server.xml里的path写成了“/shop”，但访问时用了“/mall”，结果折腾了一个小时才改对。

针对不同原因，一步步教你快速解决404

知道了原因，解决起来就简单了——针对性排查，比“瞎试代码”管用10倍。我把每个原因的解决步骤拆成了“能直接照做”的方法，你跟着来就行：

解决URL路径问题：先核对“地址牌”

第一步，用浏览器开发者工具查请求URL：打开Chrome的“检查”→“网络”标签，刷新页面，看请求的“Request URL”是不是和你写的一致。比如你写的是“/user/login”，但工具里显示的是“/user/Login”（大小写错了），直接改过来就行。

第二步，检查参数位置：如果是RESTful风格的URL（比如“/user/1”），要确保url-pattern配置了路径参数（比如“/user/{id}”）；如果是普通参数（比如“/user?id=1”），别把参数写到路径里。

第三步，测试最简URL：如果不确定路径对不对，先写一个最简的Servlet（比如url-pattern是“/test”），访问“http://localhost:8080/项目名/test”，如果能访问到，说明路径没问题；如果不能，再回头查其他原因。

解决配置文件错误：逐行核对“指挥令”

对于web.xml配置：先找标签里的 servlet-name，再找对应的标签，确保两个 servlet-name完全一致；然后检查 url-pattern的写法——想匹配所有请求用“/”，想匹配特定前缀用“/前缀/”，想精确匹配用“/具体路径”。

对于Spring MVC的@RequestMapping：先看类上的@RequestMapping（比如“/user”）和方法上的@RequestMapping（比如“/login”）组合起来是不是“/user/login”，再核对访问的URL是不是一致。如果用了@PathVariable（路径参数），要确保URL里的参数位置和注解里的一致（比如@RequestMapping("/user/{id}")对应“/user/1”）。

我之前帮朋友排查过一个web.xml错误：他把 servlet-mapping里的 url-pattern写成了“/user”，但想让所有/user开头的请求都能匹配，结果访问“/user/list”时直接404——后来改成“/user/”就好了。

解决资源位置问题：把文件“放回正确的房间”

静态资源（CSS、JS、图片）：直接放到webapp根目录下，比如webapp/css、webapp/js，访问时用“http://localhost:8080/项目名/css/style.css”就能拿到。如果想把静态资源放resources目录下，得在spring-mvc.xml里配置资源映射（比如<resources mapping="/resources/" location="/resources/">）。

JSP文件：如果想直接访问，放webapp根目录；如果想保护资源（比如后台页面），放WEB-INF/views下，然后用Controller转发——比如：

@RequestMapping("/admin")
public String adminIndex() {
 return "forward:/WEB-INF/views/admin/index.jsp";
}

这样访问“/admin”就能跳转到WEB-INF里的JSP了。

解决服务器部署问题：让服务器“听懂”你的请求

第一步，检查上下文路径：打开Tomcat的server.xml文件，找标签，看path属性是不是你要的上下文路径（比如path="/myapp"）；或者用Tomcat管理界面（默认地址“http://localhost:8080/manager/html”）查看项目的“Path”是不是正确。

第二步，确认项目已部署：看Tomcat的webapps目录下有没有你的项目文件夹（如果是war包，会自动解压成文件夹）；如果没有，重新部署一遍。

第三步，重启Tomcat**：部署后一定要重启Tomcat，否则服务器不会加载新的配置。我之前帮客户部署时，就遇到过“部署了但没重启”的情况——客户说“我都传war包了，怎么还访问不到？”，重启后立马好了。

为了方便你快速对照，我把常见原因、表现和解决步骤做成了表格，直接照着查就行：

其实404没那么可怕，无非是“地址错了”“指挥错了”“房间错了”“服务器没听懂”——你按我讲的步骤逐个排查，90%的问题都能半小时内解决。如果试过这些方法还没好，欢迎在评论区留你的报错信息，我帮你看看！

本文常见问题（FAQ）

Javaweb项目里URL大小写写错会导致404吗？

会的，大部分Javaweb服务器（比如Tomcat）默认是区分URL大小写的。比如你写的Servlet映射是“/Login”，但访问时顺手打成“/login”，哪怕就差一个大写字母，服务器也认不出来。我之前帮刚入职的小周排查过这个问题，他把“/user”写成“/User”，找了半小时才发现——就因为大小写不对，请求根本没匹配到对应的Servlet，直接弹出404。

把CSS/JS文件放进WEB-INF目录，为什么直接访问会404？

因为WEB-INF是Javaweb项目的“受保护目录”，浏览器直接输入URL访问里面的资源会被服务器拦截。比如你把首页的CSS文件放到WEB-INF/css里，想通过“http://localhost:8080/项目名/WEB-INF/css/style.css”访问，肯定会404。要解决这个问题，要么把静态资源移到webapp根目录下（比如webapp/css），要么通过服务器端转发（比如用Spring MVC配置映射），让服务器帮你获取里面的文件。

web.xml里的servlet-name和url-pattern对应错了，会导致404吗？

当然会，web.xml是服务器匹配请求的“指挥中心”，servlet-name和url-pattern必须完全对应。比如你定义的servlet-name是“UserServlet”，但url-pattern里写成了“UserServelt”（少了个“l”），那访问“/user”路径时，服务器根本找不到对应的Servlet，直接返回404。我之前帮同事排查过类似问题，就差一个字母，折腾了快一小时才改对——可见映射对应错一点都不行。

Tomcat部署时上下文路径设错了，怎么解决404？

上下文路径是项目的“访问前缀”，如果设错了，所有请求都会找不到资源。比如你部署时把上下文路径设为“/myapp”，但访问时用了“/app”，肯定会404。解决办法很简单：要么打开Tomcat的server.xml文件，找到标签修改path属性（比如把path=”/app”改成path=”/myapp”）；要么用Tomcat管理界面（http://localhost:8080/manager/html）查看项目的“Path”值，改成正确的路径就行。我之前帮客户部署时就遇到过这个问题，改完上下文路径重启Tomcat，立马就能访问了。

Spring MVC里@PathVariable路径写漏字母，会导致404吗？

会的，Spring MVC的@RequestMapping路径匹配是“精确到字符”的。比如你想写“/users/{id}”（获取用户详情），结果粗心写漏成“/user/{id}”，那访问“/users/1”时就会404——因为路径里少了个“s”，Spring MVC找不到对应的映射。我之前帮同事排查过这个问题，他说“不就是少个字母吗？至于吗？”——还真至于，后来改对路径，请求立马就通了。

YUANLEISVIP

收藏 链接