自定义Postgres镜像在Jenkins执行脚本时遇Docker权限拒绝错误

我之前也踩过类似的坑：本地跑完全正常的自定义Postgres镜像，一放到Jenkins上就报OCI runtime的exec错误。结合你的描述，给你梳理几个最常见的排查方向和解决办法：

1. 启动脚本/命令的权限与路径问题 #

报错里的exec: \...最常见的原因就是找不到要执行的命令/脚本，或者没有执行权限：

• 检查Dockerfile里的ENTRYPOINT/CMD是否用了绝对路径，比如不要写ENTRYPOINT ["init.sh"]，要写成ENTRYPOINT ["/docker-entrypoint-initdb.d/init.sh"]，避免Jenkins环境下路径解析异常。
• 给初始化脚本加上可执行权限：在Dockerfile里添加RUN chmod +x /path/to/your/init-script.sh，本地可能因为你手动加了权限没察觉，但镜像里必须明确设置。
• 检查脚本的换行格式，如果是Windows下写的脚本（CRLF换行），Linux容器执行会报错，用dos2unix转换或者在Dockerfile里加RUN sed -i 's/\r$//' /path/to/init-script.sh处理。

2. Jenkins容器的Docker权限不足 #

如果你的Jenkins是跑在容器里的，大概率是Docker socket挂载或用户权限问题：

• 启动Jenkins容器时必须挂载宿主机的Docker socket：docker run -v /var/run/docker.sock:/var/run/docker.sock ... jenkins/jenkins，否则Jenkins里的docker命令相当于在一个隔离环境里执行，和本地环境完全不一样。
• 确保Jenkins用户属于docker组，进入Jenkins容器执行usermod -aG docker jenkins，然后重启Jenkins服务，避免因为权限不够无法正确启动子容器。

3. 用户身份不一致问题 #

本地你可能用root用户跑容器，但Jenkins默认用jenkins用户执行docker命令，导致镜像里的启动脚本因为权限不足无法执行：

• 可以在Jenkins的docker run命令里加上--user root参数，临时以root身份启动Postgres容器（如果安全要求允许的话）。
• 或者在Dockerfile里明确设置USER root，确保镜像内的启动流程有足够权限。

4. 架构不匹配问题 #

如果你的本地机器是x86架构，而Jenkins服务器是ARM架构（比如M1/M2 Mac、ARM云服务器），没做多架构构建的镜像会出现执行错误：

• 用Docker Buildx构建多架构镜像，命令示例：

  docker buildx create --use
  docker buildx build --platform linux/amd64,linux/arm64 -t your-postgres-image:latest . --push
  

  这样不管是x86还是ARM环境都能正常运行。

先排除Jenkins pipeline的干扰，直接在Jenkins服务器上手动执行：

docker pull your-custom-postgres-image:latest
docker run --rm your-custom-postgres-image:latest

如果手动跑也报同样的错，那问题出在镜像本身；如果手动跑正常，那就是Jenkins pipeline里的参数、环境变量或者挂载配置有问题，重点检查pipeline里的docker命令参数。

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