Docker RUN指令与交互式Shell执行行为不一致问题排查

1. 检查启动命令的执行模式 #

如果你的CMD或ENTRYPOINT用的是exec形式（比如["npm", "start"]），容器启动时不会调用shell，LD_LIBRARY_PATH可能无法被动态链接器正确识别。

解决：

• 改用shell形式命令：CMD npm start 或 ENTRYPOINT ["sh", "-c", "npm start"]，通过shell加载环境变量。

2. 确认libjpeg运行时库已正确安装 #

别只装开发包，要装运行时版本：

• Debian/Ubuntu系统：

  RUN apt-get update && apt-get install -y --no-install-recommends libjpeg8
  

• Alpine系统：

  RUN apk add --no-cache libjpeg-turbo
  

• 构建后验证：进入容器执行ldconfig -p | grep libjpeg.so.8，确认库已被系统链接器注册。

3. 确保LD_LIBRARY_PATH在Dockerfile中提前设置 #

如果是通过docker-compose.yml或docker run -e设置的环境变量，可能晚于应用启动时机。直接在Dockerfile里配置：

ENV LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH

替换路径为实际的libjpeg所在目录。

4. 避免宿主机node_modules复制到容器 #

部分Node.js模块（如sharp）会绑定系统库，宿主机安装的node_modules在容器内可能路径不匹配。确保构建流程正确：

COPY package*.json ./
RUN npm install
COPY . .

同时确认.dockerignore里包含node_modules，防止上下文复制。

5. 排查权限问题 #

如果容器以非root用户启动，可能无权限读取libjpeg所在目录：

• 调整目录权限：

  RUN chmod -R 755 /path/to/libjpeg
  

• 临时以root用户启动容器测试，确认是否为权限导致。

6. 对比环境变量差异 #

在交互式容器中执行env > env_interactive.txt，然后修改启动命令为command: ["env"]，输出启动时的环境变量，对比两者差异，看是否有环境变量未正确加载。

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