Laravel 5.8部署至Azure 配置MySQL SSL后仍报需SSL连接错误
解决Laravel 5.8部署到Azure MySQL触发「SSL connection is required」报错
排查发现的核心配置问题
- 最容易踩的常量错配:当前配置把
BaltimoreCyberTrustRoot.crt.pem根证书的路径绑定到了PDO::MYSQL_ATTR_SSL_KEY,这个常量的作用是指定客户端身份验证用的私钥路径,根本不是放服务端根证书的位置。服务端根证书必须绑定到PDO::MYSQL_ATTR_SSL_CA对应的PDO选项,这也是配了证书依然报SSL错误的根本原因。 - SSL模式不符合Azure要求:当前默认的
sslmode值为prefer,会优先尝试无SSL通道连接数据库。Azure Database for MySQL实例默认强制开启SSL校验,无SSL连接会被服务端直接拦截抛出报错,根本不会走到加载本地证书的逻辑。 - SSL参数加载逻辑冗余:当前options数组的生成依赖
MYSQL_SSL环境变量,若未在.env文件中显式设置该变量为true,整个SSL相关参数块会被直接跳过,等同于完全没配SSL。 - 容易忽略的缓存坑:Laravel 5.8支持配置缓存机制,若修改
config/database.php前执行过config:cache命令,框架会直接读取缓存里的旧配置,修改的源文件根本不会生效。
修正后可直接复用的MySQL配置项
'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, // 固定为required模式,匹配Azure MySQL强制SSL的要求 'sslmode' => 'required', 'options' => extension_loaded('pdo_mysql') ? [ // 根证书绑定到正确的PDO常量 PDO::MYSQL_ATTR_SSL_CA => base_path('ssl/BaltimoreCyberTrustRoot.crt.pem'), // 临时排查可打开下面注释行跳过服务端证书校验,生产环境务必关闭 // PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => false ] : [] ],
部署落地的注意事项
- 确认
ssl目录下的证书文件权限:运行应用的服务账号必须有读取该证书的权限,否则就算路径配置正确也无法加载证书 - 改完配置后先执行
php artisan config:clear清除旧的配置缓存,生产环境需要优化性能的话再执行php artisan config:cache重新生成匹配当前配置的缓存文件 - 若调整配置后依然报错,可临时打开上面注释的证书校验跳过选项测试连通性,能正常连接就说明是证书链匹配问题,排查完成后再恢复证书校验开启状态

内容的提问来源于stack exchange,提问作者SheppardDigital
相关产品推荐
相关产品推荐

