Java集成OpenTelemetry时Jar包异常问题求助

问题1：no main manifest attribute, in target/asset-upload-function-1.0.0-SNAPSHOT.jar #

这个错误说明你的Jar包未在MANIFEST.MF中配置有效主类入口，按以下步骤排查：

• 检查MANIFEST.MF文件
  解压目标Jar包，查看META-INF/MANIFEST.MF文件，确认是否包含符合格式的Main-Class条目：

  Main-Class: com.your.package.YourMainClass
  

  注意冒号后必须有空格，文件末尾需保留换行符，否则配置不生效。

• 核对构建工具配置
  若使用Maven，确保maven-jar-plugin正确配置主类：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-jar-plugin</artifactId>
              <version>3.3.0</version>
              <configuration>
                  <archive>
                      <manifest>
                          <mainClass>com.your.package.YourMainClass</mainClass>
                      </manifest>
                  </archive>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

  Spring Boot项目需使用spring-boot-maven-plugin打包可执行Jar，避免用普通maven-jar-plugin生成依赖Jar。

  若使用Gradle，在build.gradle中配置主类：

  jar {
      manifest {
          attributes 'Main-Class': 'com.your.package.YourMainClass'
      }
  }
  

  Spring Boot项目则使用bootJar任务生成可执行Jar。

• 确认Jar包类型
  启动命令中的目标Jar必须是可执行Jar（包含主类入口），多模块项目需确保打包的是包含业务主类的模块Jar，而非依赖模块Jar。

问题2：偶尔出现Jar包无法访问的情况 #

这类偶发问题通常与路径、权限或系统状态相关，排查方向：

• 校验路径与权限

  • 将相对路径替换为绝对路径，比如把path/to/opentelemetry-javaagent.jar改为/opt/otel/opentelemetry-javaagent.jar，避免工作目录变化导致路径失效。
  • 检查Jar包文件权限，确保运行Java进程的用户拥有读取权限：

    ls -l target/asset-upload-function-1.0.0-SNAPSHOT.jar path/to/opentelemetry-javaagent.jar
    

    若权限不足，执行chmod +r <jar-path>添加读取权限。

• 排查系统层面干扰

  • 查看系统日志（如/var/log/messages、dmesg），确认是否存在磁盘IO异常、文件系统错误等，这类问题可能引发偶发文件访问失败。
  • 检查是否有其他进程（如构建工具、CI/CD脚本）在启动时修改或锁定Jar文件，比如打包任务未完成就启动应用，导致文件被占用。

• 验证Agent版本兼容性
  确保opentelemetry-javaagent.jar版本与你的Java版本兼容，比如Java 8需使用支持JDK 8的Agent版本，版本不匹配可能引发偶发类加载异常。

综合排查步骤 #

1. 先单独启动业务Jar，排除OpenTelemetry Agent的干扰：

   java -jar target/asset-upload-function-1.0.0-SNAPSHOT.jar
   

   若仍报主类错误，优先解决构建配置问题；若能正常启动，再添加Agent参数测试。

2. 若偶发访问问题持续，可尝试更换Agent版本，或在启动前添加文件存在校验：

   if [ -f path/to/opentelemetry-javaagent.jar ] && [ -f target/asset-upload-function-1.0.0-SNAPSHOT.jar ]; then
       java -javaagent:path/to/opentelemetry-javaagent.jar -Dotel.resource.attributes=service.name=your-service-name -Dotel.traces.exporter=zipkin -jar target/asset-upload-function-1.0.0-SNAPSHOT.jar
   else
       echo "Jar file not found!"
   fi
   

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