自制httpy包在PyPy中发起HTTPS请求时出现SSLEOFError问题

我开发了一个用于处理HTTP请求的httpy包（已发布至PyPI，仅作学习用途），该包在标准CPython环境中运行完全正常，但在PyPy环境下发起HTTPS请求时，抛出如下错误：

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/home/adam/python/httpy/httpy/__init__.py", line 2019, in request
    http_version=http_version
  File "/home/adam/python/httpy/httpy/__init__.py", line 1863, in _raw_request
    proto.send_request(sock,method,defhdr,data,path,debug)
  File "/home/adam/python/httpy/httpy/__init__.py", line 1339, in send_request
    return self.sender(*args).send(sock)
  File "/home/adam/python/httpy/httpy/__init__.py", line 1677, in send
    sock.send(self.body)
  File "/opt/pypy3/lib/pypy3.8/ssl.py", line 1173, in send
    return self._sslobj.write(data)
  File "/opt/pypy3/lib/pypy3.8/_cffi_ssl/_stdssl/__init__.py", line 546, in write
    return self._write_with_length(_str_to_ffi_buffer(bytestring), len(bytestring))
  File "/opt/pypy3/lib/pypy3.8/_cffi_ssl/_stdssl/__init__.py", line 603, in _write_with_length
    raise pyssl_error(self, length)
_cffi_ssl._stdssl.error.SSLEOFError: EOF occurred in violation of protocol

系统信息 #

• Python版本：3.10.5
• PyPy版本：3.8.13
• 操作系统：x86_64 Linux 5.18.10-arch1-1

问题分析 #

这个错误大概率和你使用ssl.wrap_socket()的方式有关，PyPy的SSL实现（基于cffi）和CPython的原生SSL模块在细节处理上存在明显差异——Requests能正常运行，是因为它针对不同Python实现的SSL兼容性做了充分适配。

可能的具体原因：

1. SSL上下文配置不完整：直接使用ssl.wrap_socket()而未设置合适的SSL上下文，PyPy的SSL实现对默认配置的兼容性更严格，CPython可能会自动补充安全配置，但PyPy不会。
2. 握手阶段数据发送时机错误：HTTPS请求必须先完成SSL握手才能发送请求体，若你在握手未完成时就调用sock.send()发送数据，PyPy的SSL层会直接抛出EOF错误，而CPython可能隐式等待握手完成。
3. 数据分片发送处理差异：PyPy的ssl.SSLSocket.send()在处理大请求体时，分片发送逻辑和CPython不同，若代码未处理send()的返回值（可能仅发送了部分数据），会导致后续数据发送时连接已被服务器关闭。

解决方案 #

1. 改用现代SSL上下文API替代ssl.wrap_socket()
   避免直接使用ssl.wrap_socket()，改用ssl.create_default_context()创建上下文，再调用context.wrap_socket()，能获得更兼容、更安全的默认配置：

   import ssl
   import socket
   
   # 创建包含安全协议、Cipher Suite的默认SSL上下文
   context = ssl.create_default_context()
   # 建立TCP连接
   sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
   sock.connect(('example.com', 443))
   # 包装为SSL套接字，自动完成握手（需指定server_hostname支持SNI）
   ssl_sock = context.wrap_socket(sock, server_hostname='example.com')
   # 握手完成后再发送请求数据
   ssl_sock.send(request_data)
   

2. 显式确保SSL握手完成
   可以主动调用ssl_sock.do_handshake()确保握手完成，再发送数据：

   ssl_sock = context.wrap_socket(sock, server_hostname='example.com')
   ssl_sock.do_handshake()  # 显式完成SSL握手
   

3. 处理send()的返回值，实现完整数据发送
   SSL套接字的send()可能无法一次性发送所有数据，需循环发送直到全部数据发送完毕：

   def send_all(sock, data):
       total_sent = 0
       while total_sent < len(data):
           sent = sock.send(data[total_sent:])
           if sent == 0:
               raise RuntimeError("连接已意外关闭")
           total_sent += sent
   

4. 参考Requests的SSL适配逻辑
   查看Requests依赖的urllib3库中对SSL套接字的处理代码，它针对PyPy等非CPython实现做了兼容性适配，能帮你完善自己的SSL处理逻辑。

内容的提问来源于stack exchange，提问作者Adam Jenča