Spring Boot 使用 Tomcat 作为容器时访问根 context-path 302分析

起因是安全团队反馈了一个漏洞，说通过公网域名访问内网中的一个SpringBoot服务的根路径，原本是域名的url变成了服务的内网的ip。
简略版的网络拓扑如下：

1. SpringBoot版本：2.2.5.RELEASE
2. server.servlet.context-path=/demo

复制代码

通过域名访问的url如下：

1. https://domain.cn/demo

复制代码

访问之后url转变为：

1. http://10.x.1/demo/

复制代码

因为网关后面的SpringBoot服务在多个机器部署，转变后的url会变成其中的一台服务器的ip。
在nginx机器上看了下日志，发现请求有一个302重定向的过程，然后变成了SpringBoot的404页面，因为根路径没有对应的handler处理。

1. Whitelabel Error Page
2. This application has no explicit mapping for /error, so you are seeing this as a fallback.
4. Fri Apr 10 23:59:59 CST 2025
5. There was an unexpected error (type=Not Found, status=404).
6. No message available

复制代码

测试环境，在Chrome中打开F12调试模式，在Network下开启Preserve log，通过SpringBoot服务所在机器的ip和端口直接访问服务的根路径，同样有一个302重定向的过程

1. http://10.x.1/demo
2. 会转变为
3. http://10.x.1/demo/

复制代码

url在302重定向后，url后面拼接了一个 /
怀疑是不是SpringBoot有什么特殊处理，SpringBoot中是通过org.springframework.web.servlet.DispatcherServlet:doDispatch方法来分发处理请求的，本地调试项目发现doDispatch方法会进入两次，DispatcherServlet上面是tomcat容器了，看样子是容器里了，往上回溯调用链发现org.apache.catalina.mapper.Mapper:internalMapWrapper方法里有一段代码有关于重定向的逻辑，代码如下：

1. if(mappingData.wrapper == null && noServletPath &&
2.         contextVersion.object.getMapperContextRootRedirectEnabled()) {
3.     // The path is empty, redirect to "/"
4.     path.append('/');
5.     pathEnd = path.getEnd();
6.     mappingData.redirectPath.setChars
7.         (path.getBuffer(), pathOffset, pathEnd - pathOffset);
8.     path.setEnd(pathEnd - 1);
9.     return;
10. }

复制代码

意思就是如果请求的路径是 "" ，那么将重定向到 / ，项目的 server.servlet.context-path=/demo，那么访问根路径，后面不加其它的url，正好就走到了这一个逻辑里面，看代码逻辑是有一个参数可以控制是否重定向的：mapperContextRootRedirectEnabled，这个是org.apache.catalina.core.StandardContext类中的一个配置参数，可以通过配置来修改

1. server.tomcat.redirect-context-root

复制代码

贴一下它的注释：

1. Determines if requests for a web application context root will be
2. redirected (adding a trailing slash) by the Mapper. This is more
3. efficient but has the side effect of confirming that the context path is
4. valid.

复制代码

修改参数的值为false，重启项目再次访问，不再出现302，而是直接到了404页面

1. server.tomcat.redirect-context-root=false

复制代码

如果项目的context-path是 / 没有302重定向的过程。
有项目使用了undertow作为容器，但是看了下undertow的代码，发现没有提供类似的参数，后面写一篇文章来记录使用undertow作为容器时出现这样情况的解决方案。
tomcat作为老牌的容器，相较undertow还是有更多灵活的配置选项。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！