You need to enable JavaScript to run this app. Laravel 5.8部署至Azure 配置MySQL SSL后仍报需SSL连接错误
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 11:24:02