Laravel 执行 config:cache 后数据库连接失败（如 Access denied），通常因配置文件中硬编码了环境相关路径或值，导致缓存时无法动态读取 .env 变量；正确做法是统一使用 env() 或 config() 函数按需解析。
laravel 执行 `config:cache` 后数据库连接失败（如 access denied），通常因配置文件中硬编码了环境相关路径或值，导致缓存时无法动态读取 `.env` 变量；正确做法是统一使用 `env()` 或 `config()` 函数按需解析。
在 Laravel 应用部署中，运行 php artisan config:cache 是提升性能的关键步骤——它将所有配置文件编译为单个优化后的 PHP 数组并缓存。但该命令有一个重要前提：所有配置值必须能在无 .env 文件的环境下静态解析。一旦你在 config/database.php（或其他配置文件）中直接写死环境敏感值（例如 SSL 证书路径、数据库用户名/密码），问题就会暴露：
// ❌ 错误示例：硬编码 SSL 路径（config/database.php）
'mysql' => [
'driver' => 'mysql',
'host' => env('DB_HOST', '127.0.0.1'),
// ... 其他配置
'options' => [
PDO::MYSQL_ATTR_SSL_CA => '/var/www/myapp/storage/certs/ca.pem', // ← 硬编码！
PDO::MYSQL_ATTR_SSL_CERT => '/var/www/myapp/storage/certs/client-cert.pem',
PDO::MYSQL_ATTR_SSL_KEY => '/var/www/myapp/storage/certs/client-key.pem',
],
],
当执行 config:cache 时，Laravel 会一次性加载并序列化整个配置数组。此时硬编码的路径被固化进 bootstrap/cache/config.php，而 env() 调用在缓存后会被跳过（Laravel 明确禁止在缓存配置中调用 env()）。更严重的是：若该路径在生产环境不存在、权限不足，或指向错误证书，PDO 连接将因 SSL 握手失败退化为普通认证，最终触发 Access denied（如 SQLSTATE[HY000] [1045]）——这正是你看到的“凭空拒绝”现象。
✅ 正确解法：将所有环境变量统一通过 env() 拉取，并确保 .env 中定义对应键：
// ✅ 正确示例：动态读取环境变量（config/database.php）
'mysql' => [
'driver' => 'mysql',
'host' => env('DB_HOST', '127.0.0.1'),
// ... 其他配置
'options' => [
PDO::MYSQL_ATTR_SSL_CA => env('DB_SSL_CA', null),
PDO::MYSQL_ATTR_SSL_CERT => env('DB_SSL_CERT', null),
PDO::MYSQL_ATTR_SSL_KEY => env('DB_SSL_KEY', null),
],
],
并在 .env 中补充：
DB_SSL_CA=/var/www/myapp/storage/certs/ca.pem DB_SSL_CERT=/var/www/myapp/storage/certs/client-cert.pem DB_SSL_KEY=/var/www/myapp/storage/certs/client-key.pem
⚠️ 注意事项：
-
切勿在配置文件中使用
$_ENV、getenv()或文件系统操作（如file_get_contents()）——这些在缓存上下文中不可靠； - 运行
config:cache前，务必先执行php artisan config:clear清除旧缓存，并确认.env已正确部署（Forge 部署脚本中建议加入cp .env.production .env && chmod 600 .env）； - 若使用
config()辅助函数（如config('database.connections.mysql.options')），需确保其调用发生在运行时（如在 Service Provider 或 Model 中），而非配置文件顶层作用域； - 对于 Forge 零停机部署，推荐在
deploy.sh中按顺序执行：git pull→composer install --no-interaction --prefer-dist --optimize-autoloader→php artisan config:clear→php artisan config:cache→php artisan migrate --force→php artisan queue:restart。
总结：config:cache 不是“魔法开关”，而是对配置可预测性的严格校验。任何绕过环境抽象的硬编码，都会在缓存后成为隐形故障点。坚持“配置即代码、环境即变量”的原则，才能让 Laravel 在开发与生产间稳定穿梭。
