Tomcat运行的Grails应用配置JaCoCo实时插装未采集业务代码覆盖的解决方法

针对你遇到的JaCoCo仅采集到Apache类覆盖、无法获取业务应用类数据的问题，可从以下几个方向排查解决：

1. 明确指定JaCoCo需要插装的业务包 #

JaCoCo默认会尝试插装所有类，但Tomcat的类加载器分层机制可能导致代理无法识别Web应用内的业务类。通过includes参数明确指定业务代码的包前缀，确保代理聚焦到目标类：

export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/root/jacocoagent.jar=destfile=/root/jacoco.exec,append=true,includes=com.yourbiz.**"

请将com.yourbiz.**替换为实际业务代码的包路径（比如Grails默认生成的grails.app.**或自定义的包前缀）。

2. 确保Tomcat启动参数配置生效 #

• 优先使用CATALINA_OPTS而非JAVA_OPTS：Tomcat官方推荐用CATALINA_OPTS存储服务专属启动参数，避免与其他Java应用的参数冲突。
• 验证参数是否加载：启动Tomcat前执行echo $CATALINA_OPTS，确认-javaagent参数已正确包含；也可在Tomcat启动后用jps -v查看进程启动参数，检查代理配置是否存在。
• 检查setenv.sh有效性：确保该文件位于Tomcat的bin目录下，且拥有可执行权限（chmod +x bin/setenv.sh），Tomcat启动时会自动加载该文件的配置。

3. 确保Grails编译时保留调试信息 #

JaCoCo需要类文件包含行号、局部变量表等调试信息才能生成准确的覆盖数据。在Grails项目的build.gradle中添加编译配置，强制保留调试信息：

tasks.withType(JavaCompile) {
    options.debug = true
    options.debugOptions.debugLevel = "source,lines,vars"
}

修改后重新打包war包，部署到Tomcat。

4. 手动触发覆盖数据写入验证 #

默认情况下，JaCoCo仅在JVM正常退出时写入jacoco.exec。若Tomcat是非正常关闭（如kill -9），可能无法生成完整文件。可通过jcmd命令手动触发数据写入：

jcmd <Tomcat_PID> org.jacoco.agent.AgentOutput write

替换<Tomcat_PID>为实际的Tomcat进程ID，生成文件后检查是否包含业务类的覆盖数据。

5. 排查类加载路径问题 #

若业务类被放置在Tomcat的lib目录（而非war包内），会由CommonClassLoader加载，需确保includes参数包含这类类的包路径；若业务类在war包内，需确认war包部署后，Tomcat的webapps/你的应用/WEB-INF/classes或WEB-INF/lib下存在对应的类文件。

内容的提问来源于stack exchange，提问作者C.A.B.