Symfony应用连接错误数据库，CLI连接正常问题求助

问题情况 #

• .env配置的数据库URL指向main数据库：

  DATABASE_URL="mysql://root:root@127.0.0.1:3306/main?serverVersion=mariadb-10.4.27"
  

• CLI执行doctrine:database:create和doctrine:migrations:migrate都能正常操作main数据库
• 浏览器访问时却报错：SQLSTATE[HY000] [1049] Unknown database 'root'

排查解决步骤 #

1. 修复.env中的转义字符 #

检查你的.env文件，确保DATABASE_URL的引号是普通双引号，而非HTML转义的"。正确的配置行应该是：

DATABASE_URL="mysql://root:root@127.0.0.1:3306/main?serverVersion=mariadb-10.4.27"

2. 确认Web环境使用的配置文件 #

Symfony会根据环境加载不同的配置文件：

• 开发环境（dev）默认用.env
• 生产环境（prod）会优先使用.env.prod或.env.local.php
  检查这些文件中的DATABASE_URL是否错误设置为指向root数据库。

3. 验证Doctrine配置 #

打开config/packages/doctrine.yaml，确认dbal部分正确引用环境变量：

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

确保没有硬编码的数据库名称（比如误写为root）。

4. 彻底清除缓存 #

执行以下命令清除对应环境的缓存：

• 开发环境：

  bin/console cache:clear --env=dev
  

• 生产环境：

  bin/console cache:clear --env=prod
  

如果缓存目录权限有问题，可手动删除var/cache目录下的所有文件，再重新生成缓存。

5. 检查Web服务器的环境变量加载 #

如果使用Apache或Nginx，确保Web服务器进程能正确读取.env文件的环境变量：

• Apache：确保启用mod_env，并在虚拟主机配置中允许环境变量传递
• Nginx：可通过fastcgi_param设置环境变量，或者确保PHP-FPM能读取.env文件

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