Azure上Tomcat 9.0.63静态站点需/ROOT访问的解决方法咨询

问题原因 #

Tomcat 9.0.54之后的版本（包括9.0.63），Azure对Tomcat的默认上下文映射规则做了调整，导致原本部署在/site/wwwroot/webapps/ROOT/的静态网站不再自动映射到根路径/，而是需要通过/ROOT访问。你之前尝试的配置（SERVER_SERVLET_CONTEXT_PATH和web.xml中的contextPath参数）要么是针对Spring Boot等框架的配置（不适用于静态网站），要么不是Tomcat的标准配置项，所以无法生效。

解决方案 #

以下是几种可行的解决方法，按推荐优先级排序：

1. 自定义Tomcat上下文配置文件

在Azure WebApp中创建/site/wwwroot/conf/Catalina/localhost/ROOT.xml文件，写入以下内容：

<Context path="" docBase="/site/wwwroot/webapps/ROOT" reloadable="true" />

这个配置会强制Tomcat将ROOT目录下的内容映射到根路径/，无需通过/ROOT访问。

2. 调整静态文件部署路径

直接将静态网站的所有文件移动到/site/wwwroot/目录下（而非webapps/ROOT子目录）。Azure WebApp的Tomcat默认会将/site/wwwroot作为根上下文的文档根目录，这样访问主域名就会直接加载该目录下的静态文件。

3. 通过JVM参数指定根上下文

在Azure门户的应用服务配置 > 应用设置中，添加以下应用设置：

名称：CATALINA_OPTS
值：-Dcatalina.base=/home/site/wwwroot -Dcatalina.home=/usr/local/tomcat -Djava.io.tmpdir=/tmp -Dserver.servlet.contextPath=/

该参数会通过Tomcat的JVM启动参数强制设置根上下文路径为/，覆盖默认配置。

关于Tomcat版本差异的说明 #

微软建议降级到9.0.54，是因为该版本之后的Tomcat更新引入了一些默认配置变更（比如上下文自动部署逻辑、默认路径映射规则），而Azure的WebApp适配层尚未完全兼容这些变更，导致ROOT应用的根路径映射失效。上述解决方案可以绕过这个适配问题，无需降级即可使用新版本Tomcat。

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