Docker中OpenJDK容器无法访问文件问题排查求助

首先明确你的场景：你构建的WebGenerator镜像中，Jar包能正常启动并访问内部嵌入资源，但始终无法访问容器内/usr/local/lib/webgenerator下的文件；且已确认文件完整复制、权限配置正常，宿主机环境运行Jar包时无此问题。

你的Dockerfile #

FROM openjdk:latest
COPY WebGenerator-1.0.0-jar-with-dependencies.jar /usr/local/lib/WebGenerator.jar
COPY webgenerator /usr/local/lib/webgenerator
EXPOSE 8085
ENTRYPOINT ["java","-jar","/usr/local/lib/WebGenerator.jar"]

构建&运行命令 #

docker build -f WebGenerator.docker -t webgenerator:1.1 .
docker run -it webgenerator:1.1

下面是按优先级排序的排查步骤：

1. 先确认Java程序的工作目录 #

Java程序如果用相对路径访问文件，会默认基于当前工作目录解析。Docker容器默认工作目录是/，但你在宿主机运行时大概率是在/usr/local/lib目录下启动Jar包，这就导致路径解析逻辑不一致。

先进入容器查看当前工作目录：

docker exec -it <你的容器ID> pwd

然后修改Dockerfile，添加WORKDIR指令指定工作目录到Jar和webgenerator所在的目录：

FROM openjdk:latest
COPY WebGenerator-1.0.0-jar-with-dependencies.jar /usr/local/lib/WebGenerator.jar
COPY webgenerator /usr/local/lib/webgenerator
# 新增：设置工作目录到目标文件夹
WORKDIR /usr/local/lib
EXPOSE 8085
ENTRYPOINT ["java","-jar","WebGenerator.jar"]

重新构建镜像运行，这是最常见的触发原因，优先测试。

2. 检查Java程序中的文件路径写法 #

如果程序里用的是绝对路径，有没有可能硬编码成了宿主机的路径？比如写了/home/your-user/webgenerator/xxx而非容器内的/usr/local/lib/webgenerator/xxx？

另外，你可以在容器内手动启动Jar包，查看程序抛出的具体异常信息：

docker exec -it <你的容器ID> java -jar /usr/local/lib/WebGenerator.jar

通过FileNotFoundException里的具体路径，能快速定位问题根源。

3. 验证容器内文件的实际可访问性 #

先排除Java程序逻辑问题，手动在容器内访问webgenerator里的文件试试：

docker exec -it <你的容器ID> cat /usr/local/lib/webgenerator/某个测试文件.txt

如果这个命令能正常输出内容，说明文件本身没问题，就是Java程序的路径逻辑问题；如果命令也报错，再检查文件的详细权限和所有者：

docker exec -it <你的容器ID> ls -ld /usr/local/lib/webgenerator
docker exec -it <你的容器ID> ls -l /usr/local/lib/webgenerator

确认文件夹和文件的权限、所有者是否匹配Java进程的运行用户（openjdk:latest默认用root运行，所以所有者为root时权限应该正常）。

4. 检查宿主机的安全限制（SELinux/AppArmor） #

如果是Linux宿主机，部分发行版默认启用SELinux或AppArmor，可能会限制容器内程序的文件访问权限，即使文件本身设置了a+rx。

可以临时关闭SELinux测试：

setenforce 0

重新运行容器后如果能访问文件，说明是SELinux限制，需要配置对应规则；或者用--privileged参数临时测试（注意：生产环境不推荐使用该参数，仅用于排查）：

docker run -it --privileged webgenerator:1.1

5. 检查Java进程的运行用户 #

虽然openjdk:latest默认用root运行，但如果你的Jar包内置了用户切换逻辑，可能导致权限不足。可以查看容器内Java进程的运行用户：

docker exec -it <你的容器ID> ps aux | grep java

如果是用非root用户运行，需要确保该用户对/usr/local/lib/webgenerator有读权限。

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