为何Docker entrypoint脚本运行失败，但容器内手动执行正常？

核心故障原因 #

• 环境变量加载逻辑差异：Docker直接执行ENTRYPOINT指定脚本时，启动的是非登录、非交互式shell，不会加载/root/.bashrc、/root/.profile等用户级配置文件。如果你的共享库路径是通过这些配置文件写入LD_LIBRARY_PATH的，直接启动脚本时就会缺失该环境变量，导致动态链接器找不到xyz.so。而你手动启动/bin/bash进入容器时属于交互式登录shell，会加载上述配置，因此可以正常运行。
• 临时环境变量未持久化：如果你是在Dockerfile的RUN指令中临时export LD_LIBRARY_PATH添加共享库路径，该配置仅在当前RUN层的shell进程生效，不会持久化到镜像的全局环境变量中，容器启动时无法继承该配置。

排查步骤 #

• 先验证LD_LIBRARY_PATH差异：
  1. 以交互式模式启动容器：docker run -it --entrypoint /bin/bash 你的镜像名，执行echo $LD_LIBRARY_PATH，记录输出的路径列表，确认xyz.so所在目录是否在列表中
  2. 在/root/build/script.sh的第一行添加代码：echo $LD_LIBRARY_PATH > /tmp/ld_path.log，重新构建镜像后正常启动，待报错后执行docker cp 报错容器名:/tmp/ld_path.log ./，对比两次输出的路径差异，确认是否缺失共享库目录
• 若需要更详细的动态链接调试信息，可在script.sh中调用依赖xyz.so的程序前添加LD_DEBUG前缀：LD_DEBUG=libs 你的程序命令，启动容器后可看到动态链接器的完整搜索路径日志，快速定位路径缺失问题

修复方案 #

• 方案1（最推荐，全局生效）：在Dockerfile中添加ENV指令持久化共享库路径：

  # 替换为xyz.so实际所在的目录路径
  ENV LD_LIBRARY_PATH=/path/to/xyz.so/dir:$LD_LIBRARY_PATH
  

• 方案2（系统级配置）：将共享库路径写入系统动态链接配置并更新缓存，在Dockerfile中添加：

  RUN echo "/path/to/xyz.so/dir" > /etc/ld.so.conf.d/xyz.conf && ldconfig
  

• 方案3（兼容原有配置）：修改ENTRYPOINT为加载bash配置后再执行脚本，保证环境变量和手动执行时一致：

  ENTRYPOINT ["/bin/bash", "-c", "source /root/.bashrc && /root/build/script.sh \"$@\"", "--"]
  CMD ["-i", "arg1", "-m", "arg2"]
  

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