树莓派Pico W的MicroPython Socket无法适配iPhone Safari浏览器问题

问题现象 #

• Pico W运行MicroPython简易HTTP服务器，Windows端Firefox可正常访问，但iPhone的Safari、Firefox均无法加载页面
• 服务器能接收到iPhone发送的完整HTTP请求，但客户端无响应
• 尝试将端口改为443（以为iOS排斥HTTP站点），结果Windows端也无法访问

核心原因 #

iOS的WebKit内核（Safari及iOS版Firefox均基于此）对HTTP响应的规范性要求远高于桌面端Firefox。原代码直接返回纯文本，缺少标准HTTP响应头，导致iOS客户端无法识别这是一个合法的HTTP响应，因此不会渲染内容。

修复后的代码 #

修改serve函数，添加完整的HTTP响应头，确保符合HTTP/1.1规范：

import network
import socket
from time import sleep

def connect():
    # 连接WLAN
    wlan = network.WLAN(network.STA_IF)
    wlan.active(True)
    wlan.connect("ssid", "password")
    while not wlan.isconnected():
        print('等待连接...')
        sleep(1)
    ip = wlan.ifconfig()[0]
    print(f"已连接，IP地址: {ip}")
    return ip

def open_socket(ip):
    # 创建Socket
    address = (ip, 80)
    connection = socket.socket()
    connection.bind(address)
    connection.listen(16)
    print(f"监听地址: {address}")
    return connection

def serve(connection):
    # 启动Web服务器
    while True:
        client = connection.accept()[0]
        request = client.recv(4096)
        print(f"收到请求: {request}")
        
        # 构造标准HTTP响应
        html = "Simple text for debugging"
        # 响应头：状态码、内容类型、内容长度、连接关闭
        response = (
            "HTTP/1.1 200 OK\r\n"
            "Content-Type: text/plain; charset=utf-8\r\n"
            f"Content-Length: {len(html)}\r\n"
            "Connection: close\r\n"
            "\r\n"  # 空行分隔头和正文
            f"{html}"
        )
        client.send(response.encode())
        client.close()

ip = connect()
connection = open_socket(ip)
serve(connection)

关键修改点说明 #

• 添加HTTP/1.1 200 OK状态行，明确告知客户端请求成功
• Content-Type指定内容类型为纯文本，确保客户端正确解析内容格式
• Content-Length告知客户端正文的字节长度，避免客户端持续等待更多数据
• 用空行\r\n\r\n分隔响应头和正文，这是HTTP规范的强制要求
• 将响应内容编码为字节流后发送（encode()），符合Socket传输的字节数据要求

额外注意事项 #

• 不要使用443端口：443是HTTPS的默认端口，需要SSL/TLS证书，MicroPython原生不支持HTTPS，强行使用会导致连接失败
• 保持端口80即可：只要响应符合HTTP规范，iOS会正常处理局域网内的HTTP请求，不存在“iOS不接受HTTP站点”的限制

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