Azure App Service部署Tomcat 9.0.62时WebContent子文件夹路径映射异常求助

问题现象 #

项目目录结构：

WebContent:   
   index.jsp  
 folder1:
   page.jsp

本地环境需通过website.com/folder1/page.jsp访问page.jsp，运行正常；但部署到Azure App Service的Tomcat 9.0.62时，page.jsp被错误映射到website.com/page.jsp，降级至9.0.54则恢复正常。

可能原因 #

• Tomcat 9.0.55+版本调整了DefaultServlet的资源查找逻辑，默认映射规则变更导致子目录资源被误解析到根路径。
• Azure对Tomcat 9.0.62的定制化配置引入了路径映射异常。
• 部署过程中目录结构被错误解析，子目录资源未被正确放置到对应路径下。

解决办法 #

1. 显式配置web.xml映射规则 #

在项目WEB-INF/web.xml中添加DefaultServlet的完整配置，覆盖Tomcat默认行为：

<servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
        <param-name>listings</param-name>
        <param-value>false</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>default</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

确保没有其他Servlet映射规则覆盖子目录路径。

2. 验证Azure部署的实际目录结构 #

通过Kudu控制台查看site/wwwroot/webapps/ROOT目录，确认folder1目录及page.jsp是否存在于正确位置。若结构异常，重新打包部署，保证WebContent下的子目录完整上传。

3. 自定义Tomcat配置文件 #

在Azure App Service的Configuration面板中，上传自定义的server.xml或context.xml，调整Host节点的appBase或Context节点的docBase配置，匹配9.0.54版本的资源映射逻辑。

4. 添加Azure路径映射规则 #

进入Azure App Service的Configuration > Path mappings，添加自定义映射：将/folder1/*指向对应的子目录资源，强制修正路径映射。

内容的提问来源于stack exchange，提问作者Shady Ashraf