跳到主要内容
外观
外观设置
显示模式
主题配色

保存在此浏览器,所有页面通用。

PHP报错 stream_socket_enable_crypto(): SSL operation failed with code 1 的排查与修复

2,454 次浏览1 次点赞

故障现象与原因

PHP程序连接SMTP邮件服务器时,出现以下错误:

stream_socket_enable_crypto(): SSL operation failed with code 1

这条信息表示TLS握手失败,不能仅凭它确定原因,应继续查看后面的OpenSSL错误详情。如果同时出现 certificate verify failed,再重点检查证书信任链、CA证书路径、服务器证书和系统时间。

本次故障中,目标服务器并非使用自签名证书,最终定位到本机 /etc/ssl/certs/ 中的CA证书文件损坏,修复系统CA证书后恢复正常。以下命令适用于Ubuntu、Debian等使用 ca-certificates 软件包的系统。

一、重装CA证书并重建信任库

ca-certificates 软件包提供系统信任的CA证书。先重装软件包,再重新生成证书链接和证书集合文件:

sudo apt-get update
sudo apt-get install --reinstall ca-certificates
sudo update-ca-certificates --fresh

--fresh 会清理 /etc/ssl/certs/ 中的证书符号链接并重新生成。无需直接删除整个目录,以免误删手动维护的文件。

如果系统使用企业内部CA,应确认对应证书仍保存在 /usr/local/share/ca-certificates/ 等受管理的位置。该目录中的本地CA证书应采用PEM格式,并使用 .crt 扩展名。

参考:Ubuntu:update-ca-certificates命令说明。

二、检查PHP实际使用的CA路径

如果系统证书修复后仍然报错,检查PHP加载的配置文件和证书搜索路径:

php --ini
php -r 'print_r(openssl_get_cert_locations());'

重点查看 ini_cafile、ini_capath,以及默认路径是否指向有效文件或目录。配置项为空不一定异常,PHP也可能使用OpenSSL默认的证书路径。

如果PHP配置了失效的自定义路径,可在实际生效的 php.ini 中修正。Ubuntu、Debian常见配置如下,填写前应确认对应路径存在且PHP进程可读:

openssl.cafile = /etc/ssl/certs/ca-certificates.crt
openssl.capath = /etc/ssl/certs

注意:命令行PHP与PHP-FPM可能加载不同的 php.ini。网页应用应核对PHP-FPM实际使用的配置;修改后重新加载对应服务。长期运行的队列进程也应重新启动,再重试发送邮件。

参考:PHP:openssl_get_cert_locations()、PHP OpenSSL运行时配置。

三、检查邮件服务器的TLS连接

将下列示例中的 smtp.example.com 替换为实际邮件服务器域名,并按服务商要求选择端口和加密方式。

587端口:STARTTLS

openssl s_client \
  -connect smtp.example.com:587 \
  -starttls smtp \
  -servername smtp.example.com \
  -verify_hostname smtp.example.com \
  -verify_return_error \
  -CAfile /etc/ssl/certs/ca-certificates.crt

465端口:隐式TLS

openssl s_client \
  -connect smtp.example.com:465 \
  -servername smtp.example.com \
  -verify_hostname smtp.example.com \
  -verify_return_error \
  -CAfile /etc/ssl/certs/ca-certificates.crt

检查输出中的证书验证结果和错误信息。连接成功后可按Ctrl+C退出。该测试用于检查TLS连接和证书验证,不代表SMTP账号认证或邮件投递一定成功。

  • 证书过期或尚未生效:检查服务器证书有效期及本机时间。
  • 主机名不匹配:使用邮件服务商提供的SMTP域名,确认证书包含该域名。
  • 无法找到颁发者证书:检查本机CA信任库,也要排查服务端是否缺少中间证书。
  • TLS连接正常,但PHP仍失败:继续检查PHP运行环境、应用自定义CA路径,以及端口和加密方式是否一致。

参考:OpenSSL:s_client命令说明。

不要通过关闭证书验证解决

在邮件配置中关闭 verify_peer、verify_peer_name 等验证选项,可能让连接暂时通过,但会失去对服务器身份的有效校验。应修复CA信任库、证书链或连接配置,保持证书验证开启。

原案例参考资料