Symfony的doctrine:database:create本地正常，Ubuntu生产环境报错求助

1. 命令执行时直接传递环境变量 #

SSH会话里单独export环境变量经常会因为上下文问题失效，直接在命令前拼接变量是最稳妥的方式：

DATABASE_URL="mysql://数据库用户名:密码@数据库地址:端口/数据库名" symfony console doctrine:database:create --env=prod --no-debug

如果服务器上已经通过系统配置（比如/etc/environment）设置了MYSQL_USER这类细分变量，也可以直接加载.env.prod再执行：

source .env.prod && symfony console doctrine:schema:create --env=prod

2. 强制指定生产环境参数 #

本地默认用dev环境配置，生产环境必须明确指定--env=prod和--no-debug，避免debug模式的配置干扰：

symfony console doctrine:database:create --env=prod --no-debug

3. 确保Doctrine配置正确读取环境变量 #

doctrine.yaml里不要硬编码数据库地址，必须用env(resolve:)语法解析嵌套变量：

doctrine:
    dbal:
        url: '%env(resolve:DATABASE_URL)%'
        # 其他DBAL配置...

resolve:关键字会自动解析DATABASE_URL里的占位符（比如%env(MYSQL_USER)%），确保嵌套环境变量被正确替换。

4. .env与.env.prod的配置规范 #

• .env提交到Git，只放本地开发用的默认值（比如本地数据库地址）
• .env.prod也提交到Git，只留占位符，不写真实敏感信息：

  # .env.prod示例
  APP_ENV=prod
  APP_SECRET=${APP_SECRET}
  DATABASE_URL=mysql://${MYSQL_USER}:${MYSQL_PASSWORD}@${MYSQL_HOST}:${MYSQL_PORT}/${MYSQL_DATABASE}
  

  生产服务器上通过系统环境变量（比如服务器面板设置、/etc/environment配置）来定义MYSQL_USER、MYSQL_PASSWORD这些真实值。

5. 检查命令执行的用户权限 #

Ubuntu服务器上如果PHP-FPM用www-data用户运行，执行命令时最好切换到该用户，避免权限问题：

sudo -u www-data DATABASE_URL="mysql://user:pass@host/db" symfony console doctrine:schema:create --env=prod

6. 验证环境变量是否生效 #

先执行以下命令确认Symfony是否读取到正确的数据库URL：

symfony console debug:container --parameter=database_url --env=prod

如果输出的是完整的数据库连接地址，说明配置没问题；如果还是占位符，检查环境变量的设置方式是否正确。

内容的提问来源于stack exchange，提问作者J.BizMai