Laravel 执行 config:cache 后数据库连接报错（如 Access denied），通常是因为配置文件中硬编码了敏感路径或值，导致环境变量未被动态解析；缓存后 .env 变更失效，而硬编码内容无法随环境切换。
laravel 执行 `config:cache` 后数据库连接报错（如 access denied），通常是因为配置文件中硬编码了敏感路径或值，导致环境变量未被动态解析；缓存后 `.env` 变更失效，而硬编码内容无法随环境切换。
在 Laravel 中，php artisan config:cache 会将所有配置文件（包括 config/database.php）静态编译为一个 PHP 数组文件（bootstrap/cache/config.php），该文件不再读取 .env 文件，也不再执行任何运行时逻辑（如 env() 调用或条件判断）。这意味着：任何在配置文件中直接写死的值（例如 SSL 证书路径、用户名、密码或 host）都将被永久固化——即使 .env 已更新，缓存配置也不会感知。
你遇到的错误：
SQLSTATE[HY000] [1045] Access denied for user 'foobar'@'xxx.xxx.xxx.xxx'
表面是认证失败，实则是缓存后的配置仍在使用旧凭据或错误路径（比如硬编码的 /var/www/old-path/server-ca.pem），而 config:clear 后恢复动态加载 .env，故恢复正常。
✅ 正确做法：始终通过 env() 函数或 config() 辅助函数间接引用环境变量，确保配置可被缓存且环境安全：
// ✅ 正确：config/database.php 中应这样写
'mysql' => [
'driver' => 'mysql',
'url' => env('DATABASE_URL'),
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE', 'forge'),
'username' => env('DB_USERNAME', 'forge'),
'password' => env('DB_PASSWORD', ''),
'unix_socket' => env('DB_SOCKET', ''),
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'prefix' => '',
'prefix_indexes' => true,
'strict' => true,
'engine' => null,
'options' => extension_loaded('pdo_mysql') ? array_filter([
PDO::MYSQL_ATTR_SSL_CA => env('DB_SSL_CA'),
PDO::MYSQL_ATTR_SSL_CERT => env('DB_SSL_CERT'),
PDO::MYSQL_ATTR_SSL_KEY => env('DB_SSL_KEY'),
]) : [],
],⚠️ 特别注意 SSL 路径字段（DB_SSL_CA、DB_SSL_CERT 等）必须定义在 .env 中，而非在 config/database.php 里写死绝对路径：
# ✅ .env —— 推荐方式 DB_SSL_CA=/etc/ssl/mysql/ca.pem DB_SSL_CERT=/etc/ssl/mysql/client-cert.pem DB_SSL_KEY=/etc/ssl/mysql/client-key.pem # ❌ 错误示例（会导致缓存后路径失效） // config/database.php PDO::MYSQL_ATTR_SSL_CA => '/home/deploy/app/storage/certs/ca.pem', // ← 硬编码！缓存后不可变
? 验证与修复步骤：
- 检查
config/database.php是否存在任何非env()的字符串字面量（尤其是 SSL 相关路径、DB credentials）； - 将所有硬编码值迁移至
.env，并统一通过env()加载； - 运行
php artisan config:clear && php artisan config:cache测试； - （可选）在部署脚本中添加校验：
php -r "print_r(config('database.connections.mysql.options'));"确认 SSL 选项已正确注入。
? 提示：Laravel 9+ 默认禁用 env() 在缓存配置中的使用（抛出异常），因此硬编码不仅导致部署问题，还会在严格模式下直接报错。坚持“配置即代码、环境即变量”的原则，是实现零 downtime 部署（如 Laravel Forge）的基石。
