Rocky Linux下Tomcat9部署BIRT运行时示例报告404错误求助

1. 检查BIRT runtime解压结构 #

• 确认解压后的BIRT目录名称正确：解压后需将核心的birt-viewer文件夹（或重命名为birt）直接放在/opt/tomcat/webapps/下，避免保留带版本号的父文件夹（如birt-runtime-4_2_2），否则会导致访问路径不匹配。
• 进入目标目录，确认birt-viewer-osgi文件夹存在且内部文件完整，无缺失或损坏。

2. 验证Tomcat上下文配置 #

• 检查Tomcat配置文件：
  • 若存在conf/Catalina/localhost/birt.xml，确保上下文路径与访问路径一致，示例配置：

    <Context docBase="/opt/tomcat/webapps/birt" path="/birt" reloadable="true"/>
    

  • 若无手动配置，Tomcat会自动以webapps下的文件夹名为上下文路径，访问示例报告时需使用标准URL格式，如http://<IP>:8080/birt/frameset?__report=sample/report/TopNReport.rptdesign，避免直接访问/birt-viewer-osgi/路径。

3. 查看Tomcat日志定位细节 #

• 搜索日志中的相关错误信息，定位具体问题：

  grep "birt-viewer-osgi" /opt/tomcat/logs/catalina.out
  

• 重点关注类加载失败、文件缺失等堆栈信息，这类日志能直接指出问题根源。

4. 匹配BIRT与Tomcat9的运行环境 #

• BIRT 4.2.2适配JDK8，Tomcat9支持JDK8至JDK11，优先使用JDK8以避免兼容性问题。
• 配置Tomcat JVM参数，创建或修改/opt/tomcat/bin/setenv.sh：

  export CATALINA_OPTS="-Xmx512m -XX:MaxPermSize=256m"
  

5. 重新部署BIRT runtime #

• 停止Tomcat服务：

  systemctl stop tomcat
  

• 删除webapps下的BIRT相关文件夹，重新解压BIRT runtime至webapps目录，确保解压过程无文件损坏，再启动服务：

  systemctl start tomcat
  

• 启动后等待1-2分钟，待Tomcat完成部署后再尝试访问示例报告。

内容的提问来源于stack exchange，提问作者Shehzad Muhammad Yousuf