ESP32 MicroPython SSL服务器搭建报错：mbedtls_ssl_handshake错误-4310

我之前在MicroPython ESP32上搭建SSL服务器时也碰到过类似的握手失败问题，结合你的描述，咱们一步步来排查和解决：

1. 先确认证书与密钥的配对性和格式 #

虽然你试过DER和PEM两种格式，但首先要确保密钥是未加密的私钥（MicroPython的ssl模块不支持带密码的加密私钥），且证书和密钥是严格配对的。你可以用openssl命令验证：

# 验证公钥模数
openssl x509 -noout -modulus -in server_cert.pem | openssl md5
# 验证私钥模数
openssl rsa -noout -modulus -in server_key.pem | openssl md5

两个命令的输出必须完全一致，否则说明证书和密钥不匹配，这是握手失败的常见原因。

如果用DER格式，要确保是正确的编码转换：

# PEM转DER证书
openssl x509 -in server_cert.pem -out server_cert.der -outform DER
# PEM转DER私钥
openssl rsa -in server_key.pem -out server_key.der -outform DER

2. 调整ssl.wrap_socket的参数使用方式 #

你当前是自己读取证书/密钥字节后传入，但部分旧版本MicroPython的ssl模块更推荐直接传入文件路径，避免手动读取时可能的字节截断或编码问题。修改这部分代码试试：

# 替换原来的wrap_socket调用
scl = ssl.wrap_socket(cl, server_side=True, certfile=CERT_PATH, keyfile=KEY_PATH)

3. 排查客户端的证书验证设置 #

你提到客户端连本地服务器正常，但要注意：本地测试时如果客户端禁用了证书验证（比如Python客户端加了verify=False或关闭了hostname检查），那连ESP32服务器时也要保持相同设置。自签名证书默认不会被客户端信任，这会直接导致握手失败。

4. 升级MicroPython固件 #

你使用的是2020年的v1.12旧固件，这个版本的mbedtls实现存在不少握手相关的bug。建议升级到最新的稳定版固件（比如v1.22+），新版本修复了大量SSL模块的内存和握手问题，大概率能解决你的-4310错误。

修改后的测试代码示例 #

import esp
esp.osdebug(None)
import gc
gc.collect()
import usocket as socket
import ssl
import network

KEY_PATH = 'server_key.pem'
CERT_PATH = 'server_cert.pem'
ssid= "AP_local"
pw="passwd"

ap = network.WLAN(network.AP_IF)
ap.config(essid=ssid, password=pw, authmode=4)
ap.ifconfig(('192.168.3.1', '255.255.255.0', '192.168.3.1', '8.8.8.8'))
ap.active(True)

# 等待AP启动完成
while not ap.active():
    pass
print('AP已启动，IP地址:', ap.ifconfig()[0])

s = socket.socket()
s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
addr = socket.getaddrinfo(ap.ifconfig()[0], 8443)[0][-1]
s.bind(addr)
s.listen(5)

print('等待SSL连接...')
while True:
    cl, addr = s.accept()
    print('客户端连接:', addr)
    try:
        # 直接传入证书/密钥文件路径
        scl = ssl.wrap_socket(cl, server_side=True, certfile=CERT_PATH, keyfile=KEY_PATH)
        print('SSL握手成功')
        
        req = scl.read(1024)
        print('收到数据:', req)
        
        # 用字节直接发送响应，避免编码问题
        response = b'HTTP/1.1 200 OK\r\nContent-Type: text/plain\r\nConnection: close\r\n\r\nOK'
        scl.write(response)
    except OSError as e:
        print('SSL错误:', e)
    finally:
        # 确保套接字关闭
        if 'scl' in locals():
            scl.close()
        cl.close()
    gc.collect()

按照这个顺序排查，应该能解决你的握手失败问题。

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