Symfony 3执行cache:clear命令时出现数据库连接超时错误求助

这个情况我碰到过好几次——网站明明能正常连数据库，但是执行php bin/console cache:clear --env=prod就报连接超时，大概率是CLI执行环境和web环境的配置差异，或者缓存清除流程的特殊要求导致的，给你几个实用的排查和解决方向：

1. 验证Prod环境CLI的数据库配置是否正确 #

虽然你说parameters.yaml里配置了凭据，但web环境（比如PHP-FPM）和CLI模式下的环境变量、配置加载可能不一样。先在服务器上执行这个命令，查看prod环境实际使用的数据库连接参数：

php bin/console debug:container --env=prod --parameter database_url

如果输出的连接信息和网站运行时的不一致，那就是配置被覆盖了——比如存在parameters_prod.yaml或者服务器上的环境变量覆盖了配置，得对应调整。

2. 给Doctrine连接增加超时时间 #

缓存清除过程中可能需要建立新的数据库连接，CLI模式的默认超时时间通常比web环境短。可以在prod环境的Doctrine配置里（config/packages/prod/doctrine.yaml）添加超时参数：

doctrine:
    dbal:
        default_connection: default
        connections:
            default:
                # 你的数据库连接配置...
                options:
                    PDO::ATTR_TIMEOUT: 30 # 把超时时间延长到30秒，按需调整

修改后再尝试执行缓存清除命令，看是否还会超时。

3. 测试CLI模式能否直接连接数据库 #

网站能访问数据库不代表CLI能访问——比如数据库服务器的安全组/防火墙只允许web服务的IP（比如Nginx的IP）访问，而CLI是从服务器本地或者另一个IP发起的连接。在服务器上直接用数据库客户端测试：

# MySQL/MariaDB的情况
mysql -h 你的数据库主机 -u 用户名 -p 你的数据库名
# PostgreSQL的情况
psql -h 你的数据库主机 -U 用户名 -d 你的数据库名

如果连不上，说明是网络权限问题，需要联系运维开放CLI所在IP的数据库访问权限。

4. 尝试跳过缓存预热 #

缓存清除默认会执行缓存预热（warmup），这个过程可能需要连接数据库。你可以试试加上--no-warmup参数跳过预热，只清除现有缓存：

php bin/console cache:clear --env=prod --no-warmup

这是个临时解决办法，但能帮你快速确认是不是预热流程导致的问题，之后再找根本原因。

5. 检查Doctrine的缓存驱动配置 #

如果你的Doctrine元数据/查询缓存用的是数据库驱动，那么缓存清除时会去连接数据库读取缓存配置，这时候就可能触发超时。建议把prod环境的Doctrine缓存换成非数据库驱动，比如Redis或者文件缓存：

# config/packages/prod/doctrine.yaml
doctrine:
    orm:
        metadata_cache_driver:
            type: redis
            host: localhost # 你的Redis地址
        query_cache_driver:
            type: redis
            host: localhost
        result_cache_driver:
            type: redis
            host: localhost

换成文件缓存的话，把type改成file即可，这样缓存清除时就不需要连接数据库了。

内容的提问来源于stack exchange，提问作者Lajdák Marek