在Azure上的Apache Tomcat中运行BIRT Viewer时遇到资源不可用问题求助

这种突然炸锅的情况确实闹心——之前稳运行快一年，突然就报/run资源找不到，重启服务器也没救，结合你用的Tomcat 9.0 + Java 11 + BIRT Viewer在Azure上的场景，我整理了几个优先级较高的排查方向：

1. 确认BIRT Viewer的部署与Servlet映射是否完好 #

• 先检查Tomcat的部署配置：
  • 查看conf/Catalina/localhost/下的BIRT相关XML文件（比如birt.xml），确认Context标签的path属性是否和你的应用根路径匹配，有没有被误删或修改。
  • 检查webapps目录下的BIRT Viewer文件夹是否存在，权限是否正常（Azure App Service的文件系统有时候会出现权限变更），确保Tomcat能读取到WEB-INF/web.xml里的/run servlet映射——你可以打开web.xml搜一下/run，确认对应的RunServlet配置有没有被注释或删除。

2. 排查类加载或依赖冲突问题 #

• 隐性更新是这类突发问题的常见诱因：
  • 查看Tomcat的logs/catalina.out或localhost.log，重点找启动时的类加载错误，比如ClassNotFoundException: org.eclipse.birt.report.viewer.web.RunServlet——如果关键类加载失败，/run servlet根本注册不上，自然返回404。
  • 校验BIRT的lib目录，看看有没有缺失的jar包，或者和Tomcat自带的jar（比如servlet-api.jar、jsp-api.jar）版本冲突的情况。有时候Azure的自动补丁或者部署脚本会意外替换依赖文件。

3. 检查Azure平台层面的配置变更 #

• Azure的平台配置有时候会悄悄影响应用：
  • 查看是否新增或修改了web.config（Windows环境）或.htaccess（Linux环境），这些文件的路由规则可能会拦截或重定向/run请求。
  • 检查App Service的应用设置，看看JAVA_OPTS或CATALINA_OPTS有没有被修改，错误的启动参数可能导致Tomcat加载异常配置。
  • 如果你的BIRT部署在Azure存储挂载目录，尝试重新部署一次BIRT Viewer包——临时存储故障可能导致部署文件损坏，重新部署能排除这个问题。

4. 验证请求路径的解析问题 #

• 虽然概率不高，但也要排查：
  • 确认客户请求的路径是严格的/run，有没有大小写错误（比如/Run）？Tomcat在某些环境下对URL大小写敏感，你可以在conf/server.xml的Connector标签里添加URIEncoding="UTF-8"和useBodyEncodingForURI="true"，确保路径解析正确。

5. 清理Tomcat缓存试试 #

• 有时候缓存损坏会导致奇怪的问题：
  • 删除Tomcatwork目录下的所有文件（这是Tomcat存储编译缓存和类实例的地方），然后重启Tomcat，让它重新生成缓存文件。这个操作不会影响你的部署文件，只是清除临时缓存，经常能解决一些莫名其妙的映射失效问题。

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