Spring Boot应用YAML配置APM Agent失败：连接默认地址被拒

问题核心原因 #

你使用的apm-agent-attach依赖属于动态挂载Agent模式，这种模式下Agent的加载时机早于Spring Boot配置初始化，因此它不会自动读取application.yml中的elastic.apm配置，只能使用默认的http://127.0.0.1:8200地址发起连接。

解决方案 #

方案1：通过JVM启动参数传递配置 #

直接在应用启动命令中添加Agent配置参数，这是动态挂载模式下最直接的生效方式：

java -Delastic.apm.enabled=true \
     -Delastic.apm.application_packages=com.#####.cpoeventskafka \
     -Delastic.apm.capture_body=true \
     -Delastic.apm.server_url=http://10.###.##.5:8200 \
     -Delastic.apm.environment=dev \
     -Delastic.apm.service_name=cpo-event \
     -jar your-app.jar

方案2：使用apm-agent.properties配置文件 #

在项目resources目录下创建apm-agent.properties文件，写入以下配置，动态挂载的Agent会自动读取这个文件：

elastic.apm.enabled=true
elastic.apm.application_packages=com.#####.cpoeventskafka
elastic.apm.capture_body=true
elastic.apm.server_url=http://10.###.##.5:8200
elastic.apm.environment=dev
elastic.apm.service_name=cpo-event

方案3：替换为Spring Boot Starter依赖（推荐） #

如果希望通过Spring Boot的application.yml统一管理配置，建议替换依赖为官方提供的starter：

<dependency>
   <groupId>co.elastic.apm</groupId>
   <artifactId>apm-agent-spring-boot-starter</artifactId>
   <version>1.50.0</version>
</dependency>

替换后，你原来的application.yml配置就能直接生效，无需额外调整。

额外验证建议 #

1. 连通性测试：在应用服务器上执行curl http://10.###.##.5:8200，确认APM Server地址可正常访问
2. 版本兼容性：你的Agent版本是1.50.0，APM Server是7.17.0，虽然跨版本兼容，但尽量对齐大版本（比如把Agent换成7.17.24）能避免潜在问题

内容的提问来源于stack exchange，提问作者Aldo Inácio da Silva