本地IntelliJ使用Elastic APM报错：ElasticApmAttacher类未找到

问题原因 #

你遇到的java.lang.NoClassDefFoundError: co/elastic/apm/attach/ElasticApmAttacher错误，核心原因是IntelliJ与Eclipse对provided范围依赖的运行时处理逻辑不同：

• Eclipse默认会将provided范围的依赖包含在项目运行类路径中
• IntelliJ默认不会加载provided依赖，除非显式配置

你的apm-agent-attach依赖使用了<scope>provided</scope>，这导致IntelliJ运行项目时找不到该类。

解决方案 #

1. 修改依赖范围（最简单直接） #

将apm-agent-attach的依赖范围从provided改为compile，这样IntelliJ会自动将该依赖加入运行类路径：

<dependency>
    <groupId>co.elastic.apm</groupId>
    <artifactId>apm-agent-attach</artifactId>
    <version>1.39.0</version>
    <scope>compile</scope>
</dependency>

2. 配置IntelliJ运行时加载provided依赖 #

如果不想修改依赖范围，可以在IntelliJ的运行配置中开启加载provided依赖：

• 打开Run/Debug Configurations（右上角运行按钮旁的下拉菜单 → Edit Configurations）
• 选择你的Spring Boot运行配置
• 切换到Dependencies标签页
• 勾选Include dependencies with "Provided" scope选项
• 保存配置后重新运行项目

3. 手动添加代理Jar到类路径 #

如果以上两种方式都不适用，可以手动下载apm-agent-attach-1.39.0.jar，然后：

• 在IntelliJ中打开Project Structure（File → Project Structure）
• 选择Libraries → 点击+号添加本地Jar文件
• 确保该库被添加到你的项目模块的依赖中

4. 重新同步Maven项目 #

有时依赖同步不完整也会导致此类问题：

• 点击IntelliJ右侧Maven面板的Reload All Maven Projects按钮
• 等待同步完成后清理并重新构建项目（Build → Clean Project → Build Project）

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