Spring Boot 3.1.1微服务New Relic事务归类异常求助

可能原因 #

• 控制器未被Agent识别拦截：该微服务的控制器使用了非Spring MVC标准注解、或类/方法访问修饰符非public，导致APM Agent无法识别为请求处理入口，跳过了控制器层的追踪。
• Spring组件扫描失效：微服务的@ComponentScan或@SpringBootApplication的扫描范围未包含控制器所在包，控制器未被Spring容器管理，Agent无法追踪到对应的请求处理逻辑。
• 字节码注入冲突：微服务引入了其他字节码增强工具（如自定义增强框架、安全类库），与APM Agent的字节码注入逻辑冲突，导致控制器方法的追踪代码未被成功注入。
• 请求路由未匹配控制器：所有API请求未匹配到任何控制器方法，直接由DispatcherServlet处理（如路由配置错误、路径不匹配），因此没有生成控制器层的追踪节点。

解决方法 #

• 检查控制器配置：确认控制器类为public修饰，使用@RestController、@GetMapping/@PostMapping等标准Spring MVC注解；若使用自定义注解，需在Agent配置中添加对该注解的支持（如配置transaction_naming_rules规则识别自定义注解）。
• 验证组件扫描：查看@SpringBootApplication的scanBasePackages属性或@ComponentScan配置，确保控制器所在包被纳入扫描范围；可通过Spring Boot Actuator的/actuator/beans端点确认控制器实例已被加载。
• 排查字节码冲突：临时禁用其他字节码增强工具，重启服务后观察追踪是否恢复。若恢复，调整Agent与其他工具的加载顺序，或在Agent配置中排除冲突类/包。
• 检查请求路由：开启Spring MVC的DEBUG日志（logging.level.org.springframework.web=DEBUG），查看请求是否正确匹配到控制器方法；修正@RequestMapping的路径、请求方法等配置，确保请求触发控制器逻辑。
• 手动配置事务命名规则：若以上方法无效，可通过Agent配置强制生成事务名，示例：

  transaction_naming_rules=^Servlet/org.springframework.web.servlet.DispatcherServlet/service$ -> {http.method} {http.request.uri}
  

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