Docker Secret转换为数据库连接环境变量不被SQLAlchemy解析

你遇到的核心问题有两个：

1. Docker Secrets环境变量赋值错误：当前docker-compose里的环境变量只是把Secret的名称直接赋值给变量（比如DB_LANG_DRIVER=db_lang_driver），并没有读取Secret文件里的实际内容，导致Python代码拿到的是字符串"db_lang_driver"而非真实的驱动值。
2. 数据库连接字符串格式错误：即使拿到正确的Secret值，你的拼接方式也不符合SQLAlchemy要求的RFC1738 URL格式，缺少必要的分隔符（如://、:、@、/）。

方法1：在docker-compose中通过命令读取Secret内容到环境变量 #

修改docker-compose.yml，去掉原有的环境变量赋值，通过启动命令读取Secret文件内容并注入环境变量：

version: '3.3'
services:
  stripe:
    image: stripe-full-env
    container_name: stripe
    ports:
      - "7000:7000"
    secrets:
      - stripe-secret-key
      - db_lang_driver
      - db_user
      - db_password
      - db_host
      - db_database
    # 替换原有的environment和command，通过sh命令读取Secret并启动应用
    command: >
      sh -c '
        export STRIPE_SECRET_KEY=$(cat /run/secrets/stripe-secret-key) &&
        export DB_LANG_DRIVER=$(cat /run/secrets/db_lang_driver) &&
        export DB_USER=$(cat /run/secrets/db_user) &&
        export DB_PASSWORD=$(cat /run/secrets/db_password) &&
        export DB_HOST=$(cat /run/secrets/db_host) &&
        export DB_DATABASE=$(cat /run/secrets/db_database) &&
        python your_app.py  # 替换成你的应用启动命令
      '
secrets:
  stripe-secret-key:
    file: ./stripe-secret-key.txt
  db_lang_driver:
    file: ./db_lang_driver.txt
  db_user:
    file: ./db_user.txt
  db_password:
    file: ./db_password.txt
  db_host: 
    file: ./db_host.txt
  db_database:
    file: ./db_database.txt

方法2：Python代码直接读取Docker Secrets文件 #

Docker会自动将Secrets挂载到容器内的/run/secrets/<secret-name>路径下，你可以直接读取这些文件的内容，同时修正连接字符串的格式：

import os
from sqlalchemy import create_engine

def load_secret(secret_name):
    secret_path = f'/run/secrets/{secret_name}'
    if not os.path.exists(secret_path):
        raise ValueError(f"Secret file {secret_path} not found")
    with open(secret_path, 'r') as f:
        # 读取后去除首尾空白（避免文件中的换行符或空格影响）
        return f.read().strip()

# 加载各个Secret值
db_lang_driver = load_secret('db_lang_driver')
db_user = load_secret('db_user')
db_password = load_secret('db_password')
db_host = load_secret('db_host')
db_database = load_secret('db_database')
stripe_secret_key = load_secret('stripe-secret-key')

# 按照SQLAlchemy要求的格式拼接连接字符串
# 格式示例：postgresql://user:password@host/dbname
strConnection2 = f"{db_lang_driver}://{db_user}:{db_password}@{db_host}/{db_database}"

engine = create_engine(
    strConnection2, 
    echo=False, 
    pool_recycle=900, 
    pool_pre_ping=True, 
    pool_size=1000,
    max_overflow=2000
)

• 确保你的Secret文件（如db_lang_driver.txt）中只包含对应的值，不要有多余的换行符或空格，否则会导致连接字符串解析失败。
• SQLAlchemy的数据库URL必须严格遵循dialect+driver://user:password@host:port/dbname格式，缺少任何分隔符都会触发ArgumentError。

内容的提问来源于stack exchange，提问作者Gustavo M.