Docker Compose文件定义环境变量时遇语法错误问题求助

执行docker-compose build时出现错误：unexpected character "," in variable name near ","，结合你提供的环境变量内容和Compose片段，问题出在环境变量的配置格式上，以下是具体解决步骤：

1. 修正.env文件语法（推荐方式） #

如果通过.env文件管理环境变量，必须严格遵循KEY=VALUE格式规范：

• 变量名不能包含逗号、空格等特殊字符
• 变量值无需额外添加双引号（除非值本身包含引号或空格）
• 注释行必须以#开头，不能与变量行混写

修正后的.env文件示例：

# ApacheRabbitMQ
RABBITMQ_CONN=amqp+ssl://b-d8788e14-1.mq.us-east-2.amazonaws.com:5671

# AWS
S3_BUCKET=YOURS3BUCKET
SECRET_KEY=YOURSECRETKEYGOESHERE

# JWT
JWT_SECRET=
JWT_ISSUER=
JWT_SUBJECT=
JWT_ALGORITHM=
JWT_EXPIRES=
DATE_FORMAT=

# PAYOUT SERVICE
# STANBIC_URL=https://stannnel.ank.com/stanbic-outward 
STANBIC_URL=https://providus./providus
NIP_URL=https://niay.tank.com/nip-mini
RAIL=stanbic
PAYOUT_SECRET_KEY=iie2eEiKgjJPVgSOfiq+wePp1fCq1A= 
# production iiebXVgSOfiq+wePp1fCq1A=
# test R2V0GhAS3JlZGlUZXN0
# GENERAL_LEDGER_ID=3

2. 在Docker Compose中正确配置环境变量 #

修改你的docker-compose.yml，选择以下任一方式配置环境变量：

方式一：加载.env文件 #

version: '3'
services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - '3000:3000'
    env_file:
      - .env  # 指定.env文件的路径

方式二：直接定义环境变量 #

若无需单独的.env文件，可直接在Compose中列出变量：

version: '3'
services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - '3000:3000'
    environment:
      - RABBITMQ_CONN=amqp+ssl://b-d8788e14-1.mq.us-east-2.amazonaws.com:5671
      - S3_BUCKET=YOURS3BUCKET
      - SECRET_KEY=YOURSECRETKEYGOESHERE
      # 其余变量按此格式依次添加

3. 关键错误排查点 #

• 检查Compose文件environment字段的语法：使用列表形式时，每个变量行末尾不能有多余逗号
• 确认.env文件中没有行尾多余的逗号或其他无效特殊字符
• 变量值中的特殊字符（如+）无需转义，Docker Compose会自动处理

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