Heroku维护后Mac MAMP连接Heroku Postgres报错解决方案

别光查系统TLS版本，MAMP是完全独立的打包环境，自带的Postgres客户端底层库libpq是随安装包内置的旧版本，哪怕你Mac系统本身已经支持TLS 1.3，MAMP里的PHP也不会调用系统的TLS栈，内置旧版libpq默认会用TLS1.0/1.1发起握手，直接被升级后的Heroku Postgres拒绝，才会报tlsv1 alert protocol version的错。

方案1：快速验证（优先试，1分钟搞定） #

直接修改PDO连接配置，强制指定SSL模式和最低TLS版本，禁止驱动自动回退到旧协议：

// PDO初始化代码
$pdo = new PDO(
    'pgsql:host=你的Heroku库地址.compute-1.amazonaws.com;dbname=你的库名;sslmode=require',
    '你的数据库账号',
    '你的数据库密码',
    [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        // 强制最低TLS版本为1.2
        'ssl_min_protocol_version' => 'TLSv1.2'
    ]
);

踩坑提示：如果你用的MAMP版本低于6.6，内置的libpq版本在12以下，根本不识别ssl_min_protocol_version参数，试了没用直接走方案2。

方案2：替换MAMP内置旧依赖（根治方案） #

把MAMP自带的老旧libpq替换成Homebrew安装的新版，一劳永逸：

1. 终端执行命令安装新版libpq：

   brew install libpq
   

2. 备份MAMP自带的旧库文件，替换为新版软链：

   # 备份旧文件，防止出问题可以回滚
   mv /Applications/MAMP/Library/lib/libpq.5.dylib /Applications/MAMP/Library/lib/libpq.5.dylib.bak
   
   # M系列芯片Mac执行这条
   ln -s /opt/homebrew/opt/libpq/lib/libpq.5.dylib /Applications/MAMP/Library/lib/libpq.5.dylib
   
   # Intel芯片Mac执行这条
   # ln -s /usr/local/opt/libpq/lib/libpq.5.dylib /Applications/MAMP/Library/lib/libpq.5.dylib
   

3. 重启MAMP的PHP服务，输出phpinfo()找到pdo_pgsql项，确认对应的libpq版本≥12，再连库就正常了。

方案3：临时应急方案 #

不想改MAMP配置的话，可以用SSH隧道把远程库映射到本地端口，让隧道工具处理TLS握手，PHP连本地端口即可：

1. 终端执行端口映射命令，把远程Heroku Postgres的5432端口映射到本地5433：

   ssh -L 5433:你的Heroku库地址.compute-1.amazonaws.com:5432 -N 你的Heroku隧道账号
   # 装了Heroku CLI的话可以直接用快捷命令
   # heroku pg:psql --app 你的Heroku应用名
   

2. 把PDO连接地址改成127.0.0.1:5433，不需要加SSL参数就能正常连接。

写完配置跑个测试脚本，执行SELECT version();，能正常返回Postgres版本信息就说明修复完成，不会再报TLS版本错误。

内容的提问来源于stack exchange，提问作者Wisam22