Docker容器传递环境变量失败：OCI runtime create failed求助

我之前也碰到过一模一样的问题，折腾了好一会儿才找到原因，给你几个实用的排查方向：

• 先检查环境变量的格式是否正确
  这是最容易踩的坑：

  • 不要在=两边加空格，比如-e MY_VAR = test是错误写法，必须写成-e MY_VAR=test
  • 如果变量值包含空格、特殊字符（比如!、$），一定要用双引号括起来，比如-e "MY_VAR=Hello! World"
  • 变量名尽量用大写字母加下划线的规范格式，避免特殊字符

• 验证镜像启动脚本对环境变量的兼容性
  有些镜像的ENTRYPOINT或CMD脚本会对环境变量有严格要求，比如必须存在某个变量、变量格式不符合预期就会启动失败。你可以先不带环境变量启动容器，进去手动测试：

  docker run -it --rm your-image-name sh
  # 然后在容器内手动设置环境变量，执行启动命令
  export MY_VAR=test
  /path/to/start-script.sh
  

  这样能快速定位是环境变量的问题，还是镜像本身的启动逻辑有问题。

• 查看容器的详细错误日志
  即使容器处于created状态，也可能有关键日志输出。用容器ID或名字查看日志：

  docker logs <container-id-or-name>
  

  日志里通常会有更具体的错误信息，比如某个环境变量缺失、格式错误，或者启动脚本抛出的异常。

• 尝试用--env-file传递变量
  如果命令行里的环境变量太多或格式复杂，很容易出现解析错误。可以把所有变量写到一个文件（比如env.list），每行格式为KEY=VALUE，然后用以下命令启动：

  docker run --env-file env.list your-image-name
  

  这种方式能避开命令行解析的坑，先确认这样能不能成功运行。

• 检查Docker版本和运行时状态
  旧版本的Docker可能存在OCI runtime的兼容bug，建议升级到最新稳定版。另外也可以重启Docker daemon试试：

  # Linux系统
  sudo systemctl restart docker
  # macOS/Windows可在Docker Desktop里重启服务
  

• 排查安全模块的干扰
  如果是Linux系统，SELinux或AppArmor可能会限制容器的操作，导致环境变量传递失败。可以临时关闭SELinux测试：

  sudo setenforce 0
  

  如果关闭后能正常运行，再去配置对应的SELinux规则，不要一直关闭安全模块。

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