当前位置：首页 > news >正文

【Nginx】Nginx代理Tomcat配置及404问题解决

news 来源：原创 2025/6/23 19:38:24

当Tomcat返回HTTP 404未找到错误时，可以通过以下两种方式设置跳转到指定地址：
① 在Tomcat应用内部配置错误页面跳转（直接修改Tomcat的Web应用配置）
② 在Nginx反向代理层拦截404错误并跳转（无需修改Tomcat，由Nginx统一处理）。

以下是具体配置方法：

方法1：在Tomcat应用中配置404跳转（修改web.xml）

适用于直接控制Tomcat应用的情况，通过定义错误页面实现跳转。

步骤：

修改应用的web.xml文件
在Tomcat应用的WEB-INF/web.xml（或全局的conf/web.xml）中添加以下配置：

<!-- 定义404错误跳转到指定路径 -->
<error-page>
    <error-code>404</error-code>
    <location>/custom-404.html</location>  <!-- 跳转到应用内的静态页面 -->
    <!-- 或跳转到外部URL -->
    <!-- <location>https://example.com/not-found</location> -->
</error-page>

创建自定义错误页面（可选）
如果跳转到应用内页面（如/custom-404.html），需在Web应用的根目录下创建对应文件。

重启Tomcat生效

# 重启Tomcat服务
sudo systemctl restart tomcat

方法2：在Nginx反向代理层拦截404并跳转

适用于通过Nginx代理Tomcat的场景，无需修改Tomcat配置，直接在Nginx中处理错误。

步骤：

修改Nginx配置文件
在Nginx的server块中添加以下配置，拦截Tomcat返回的404错误并重定向：

server {
    listen 443 ssl;
    server_name example.com;

    # SSL配置...

    # 代理到Tomcat
    location / {
        proxy_pass http://tomcat-server:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;

        # 关键配置：启用错误拦截
        proxy_intercept_errors on;
    }

    # 捕获404错误并跳转到指定地址
    error_page 404 =301 https://example.com/not-found;
    # 或跳转到静态页面
    # error_page 404 /custom-404.html;
    # location = /custom-404.html {
    #     root /usr/share/nginx/html;
    #     internal;  # 仅允许内部访问
    # }
}

验证并重载Nginx

# 检查配置语法
sudo nginx -t

# 重新加载配置
sudo nginx -s reload

验证跳转是否生效

访问一个不存在的URL：
例如 https://example.com/non-existent-path，观察是否自动跳转到指定地址。
使用curl测试：
```
curl -v https://example.com/non-existent-path
```
检查响应头中的 Location 字段（跳转时）或返回的自定义页面内容。

常见问题排查

Tomcat未返回真实404状态码
确保Tomcat应用在资源不存在时正确返回404（而非其他状态码如500）。
Nginx未启用proxy_intercept_errors
必须设置 proxy_intercept_errors on;，否则Nginx不会处理后端返回的错误码。
路径或权限问题
- 检查自定义错误页面的路径是否存在且可读。
- 确认Nginx配置中的跳转地址可公开访问（如外部URL需有效）。