Docker容器加载.env环境变量报错：格式错误含空格

• 修正.env文件的变量格式
  Docker的--env-file解析规则和dotenv存在差异：dotenv支持用反引号包裹多行JSON，但Docker要求带空格/特殊字符的变量值必须用双引号包裹，且内部双引号要转义。
  原本地可用但Docker报错的格式：

  SERVICE_KEY=`{"project_id": "my-image", "other_key": "value"}`
  

  修正后可兼容Docker的格式：

  SERVICE_KEY="{\"project_id\": \"my-image\", \"other_key\": \"value\"}"
  

  注意：去掉反引号，将JSON压缩为单行，转义所有内部双引号。

• 直接在docker run命令中传递变量
  绕过.env文件的解析限制，直接用-e参数在命令行传递变量，用单引号包裹整个JSON字符串（shell会保留单引号内的原始格式，无需转义内部双引号）：

  docker run -p 3000:3000 -d -e SERVICE_KEY='{"project_id": "my-image", "other_key": "value"}' image-name
  

• 挂载JSON文件替代环境变量传递
  将SERVICE_KEY的JSON内容单独存入service-key.json文件，通过Docker挂载传入容器，让Node.js直接读取文件解析：

  1. 项目根目录创建service-key.json，写入JSON内容：

     {"project_id": "my-image", "other_key": "value"}
     

  2. 启动容器时挂载文件：

     docker run -p 3000:3000 -v $(pwd)/service-key.json:/app/service-key.json -d image-name
     

  3. 修改Node.js代码，直接读取/app/service-key.json文件解析，不再依赖环境变量。

• 检查.env文件的换行和冗余字符
  Docker的--env-file不支持多行环境变量，确保SERVICE_KEY的JSON内容没有换行、多余空格，完全压缩为一行后再按规则包裹。

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