Java Web项目部署在Tomcat运行出错与解决方法示例

下面将详细讲解Java Web项目部署在Tomcat运行出错的常见问题及解决方法，包含两个示例说明。

1. 问题1：404 Not Found错误

1.1 错误现象描述

在 Tomcat 运行 Java Web 项目时，当用户访问某个页面时，浏览器显示 404 Not Found 错误页面，而在本地项目调试中却正常访问。

1.2 解决方法

该问题的主要原因是访问的 URL 地址和实际上的网页文件不匹配。通常解决该问题的方法有以下几个步骤：

1. 首先需要检查项目路径是否设置正确，特别是在使用相对路径引用 js、css 等文件时需要小心。可以在 Tomcat 部署目录下的logs目录中查看 catalina.out 或 catalina.log 文件，查看是否存在错误提示。如果是路径错误导致的问题，错误提示会告诉你访问的文件哪里没有找到。

2. 如果确定路径无误，那么就需要检查配置文件中的 servlet、mapping 是否正确。在 web.xml 文件中检查所需的 servlet 类和参数是否正确地映射到 URL。例如：

<servlet>
    <servlet-name>TestServlet</servlet-name>
    <servlet-class>com.example.TestServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>TestServlet</servlet-name>
    <url-pattern>/test</url-pattern>
</servlet-mapping>

1. 如果以上两个步骤都没有解决问题，那么可能是项目缺少所需的 jar 包。通过查看项目中使用到的 jar 包是否都已经在项目的 WEB-INF/lib 目录下，并确保所有依赖的 jar 包都被正确导入。可以尝试从文件系统中手动删除 WEB-INF 下缺失的 jar 包，并重新拷贝一份。

1.3 示例

在一个 Java Web 项目中，存在如下代码：

@RequestMapping(value = "/home", method = RequestMethod.GET)
public ModelAndView homePage() {
    ModelAndView modelAndView = new ModelAndView("homePage");
    return modelAndView;
}

在访问 http://localhost:8080/myproject/home 时，浏览器会显示 404 Not Found 错误页面。经过排查，发现是 homePage.html 页面未设置正确的访问路径，应该为：

...
<form th:action="@{/home}" method="get">
...

修改后重新部署项目即可正常访问。

2. 问题2：415 Unsupported Media Type 错误

2.1 错误现象描述

在 Tomcat 运行 Java Web 项目时，当用户提交表单时，出现 415 Unsupported Media Type 错误页面。

2.2 解决方法

该问题通常是由于提交的参数类型与后端接口的请求类型不匹配导致的。解决方法如下：

1. 确认接口的传参类型，是 application/json，还是 application/x-www-form-urlencoded，或者其他类型。

2. 在前端代码中，务必设置正确的请求头，例如：

$.ajax({
    url: '/api/updateUser',
    type: 'put',
    contentType: 'application/json;charset=UTF-8', // 设置请求头部分
    data: JSON.stringify({id: 1, name: 'test'}),
    success: function (response) {
        console.log(response);
    }
});

1. 在后端接口中，添加正确的注解，例如：

@RequestMapping(value = "/updateUser", method = RequestMethod.PUT, consumes = "application/json")
@ResponseBody
public Map<String, Object> updateUser(@RequestBody User user) {
    // do something
}

2.3 示例

在一个 Java Web 项目中，存在如下代码：

$.ajax({
    url: '/api/user/register',
    type: 'post',
    contentType: 'application/x-www-form-urlencoded;charset=UTF-8', // 设置请求头部分
    data: {
        username: 'test',
        password: '123456'
    },
    success: function (response) {
        console.log(response);
    }
});

该代码提交表单的参数类型为 application/x-www-form-urlencoded，然而后端接口的请求类型为 application/json，因此会导致 415 Unsupported Media Type 错误。修改后端接口的代码如下：

@RequestMapping(value = "/register", method = RequestMethod.POST, consumes = "application/x-www-form-urlencoded")
@ResponseBody
public Map<String, Object> register(@RequestParam String username, @RequestParam String password) {
    // do something
}

将接口的 consumes 参数设置为 application/x-www-form-urlencoded，或者将前端请求头的 contentType 属性设置为 application/json 即可解决问题。