Gradle镜像运行失败：JAVA_HOME无效及容器权限异常问题

问题现象 #

执行docker run -it gradle:8.4.0-jdk17 /bin/bash进入容器后，运行gradle -v出现两个错误：

• ls: cannot access '/usr/bin/gradle': Operation not permitted
• ERROR: JAVA_HOME is set to an invalid directory: /opt/java/openjdk

解决步骤 #

1. 修正JAVA_HOME环境变量
   先定位容器内Java的实际安装路径：

   readlink -f /usr/bin/java | sed "s:/bin/java::"
   

   执行后会返回Java的根目录（比如/usr/lib/jvm/java-17-openjdk-amd64），接着设置正确的JAVA_HOME：

   export JAVA_HOME=返回的Java根目录路径
   

2. 解决gradle权限问题
   报错是因为gradle镜像默认以gradle用户运行，无/usr/bin/gradle的访问权限。两种解决方式：

   • 进入容器后切换到root用户（默认无密码，直接回车）：

     su root
     

   • 启动容器时直接指定root用户：

     docker run -it --user root gradle:8.4.0-jdk17 /bin/bash
     

验证 #

完成上述操作后再次执行gradle -v，即可正常输出Gradle与Java的版本信息。

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