Jib构建SpringBoot镜像后Java Agent启动失败报agent library failed to init错误

问题原因及解决方案 #

这个报错的核心是Java进程无法正常读取你指定的newrelic.jar代理包，虽然文件在镜像中存在，但通常是权限、文件完整性或者路径匹配的问题，你可以按以下顺序排查修复：

• 文件权限配置错误（最高概率）
  Jib默认构建的镜像会使用非root用户（默认UID为1000）启动Java进程，如果你在复制newrelic目录时没有显式配置文件权限，Jib默认设置的权限可能导致运行用户没有读取jar包、访问目录的权限。
  你需要在Jib配置中补充权限配置，示例如下：

jib {
    extraDirectories {
        paths {
            path {
                from = file('newrelic') // 替换为你本地的newrelic目录路径
                into = '/app/libs/newrelic'
            }
        }
        // 给目录设置可进入权限，给所有文件设置可读权限
        permissions = [
            '/app/libs/newrelic': '755',
            '/app/libs/newrelic/**': '644'
        ]
    }

    container {
        // 确认这里的路径和你复制的路径完全一致，没有拼写/大小写错误
        jvmFlags = ["-javaagent:/app/libs/newrelic/newrelic.jar"]
        // 其他容器配置
    }
}

• newrelic.jar本身损坏
  你可以在本地执行命令jar -tf newrelic/newrelic.jar测试jar包完整性，如果命令报错无法列出内容，说明本地的jar包本身已损坏，重新下载对应版本的NewRelic Java Agent即可。
• Jib版本已知问题
  你使用的3.1.2版本Jib插件存在小概率的文件权限继承异常问题，你可以尝试将Jib插件升级到3.2.0及以上版本后重新构建镜像测试。

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