CircuitPython实现Android免弹窗连接Pico W AP及Captive Portal问题排查

核心问题分析 #

• Android设备连接无互联网的AP时，会触发网络连通性检测（默认请求connectivitycheck.gstatic.com等域名），若检测不到有效互联网连接，会弹出"无互联网连接"确认弹窗。
• 你的DNS拦截已能识别请求，但重定向失败，通常是因为DNS响应未正确指向AP的HTTP服务器，或HTTP服务器未处理Captive Portal的特定检测请求。

具体解决步骤 #

1. 修正DNS拦截的响应逻辑 #

确保DNS服务器对所有域名请求都返回AP的IP（192.168.4.1），而不是仅识别请求但不返回正确解析结果：

• 检查network.py中的DNS处理代码，确认当收到任何A记录请求时，返回192.168.4.1的IP地址（以字节数组形式构造DNS响应包）。
• 注意DNS响应的格式正确性：需包含正确的ID、标志位、问题计数、回答计数，以及正确的资源记录（TTL、类型、类、IP数据）。

2. 适配Android的Captive Portal检测 #

Android的连通性检测会发送特定请求，需让HTTP服务器正确响应：

• 在你的HTTP服务器代码中，针对GET /generate_204（Android默认检测路径）或GET /请求，返回302重定向到你的交互页面（http://192.168.4.1/），或者直接返回204状态码（仅关闭弹窗，不引导到页面）。
• 示例HTTP响应头（重定向）：

  HTTP/1.1 302 Found
  Location: http://192.168.4.1/
  Content-Length: 0
  

3. 完善AP的网络配置 #

• 确保Pico W的AP模式配置中，DHCP服务器正常工作，为连接的设备分配正确的IP段（比如192.168.4.2-192.168.4.20），网关和DNS服务器均设为192.168.4.1。
• 检查network.py中的AP初始化代码，确认network.WLAN(network.AP_IF).config(dhcp_hostname='pico-ap', gateway='192.168.4.1', dns='192.168.4.1')这类配置是否正确。

4. 调试与验证 #

• 使用Android设备的浏览器访问任意域名，确认是否自动跳转到192.168.4.1。
• 查看DNS拦截的运行日志，确认所有请求都被解析到192.168.4.1；查看HTTP服务器日志，确认收到Captive Portal的检测请求并返回正确响应。

代码调整示例（参考） #

假设你的DNS处理函数需要返回正确的IP解析：

def dns_response(data):
    # 解析DNS请求
    req = dns.DNSRequest(data)
    if req.type == dns.TYPE_A:
        # 构造响应，返回192.168.4.1
        resp = dns.DNSResponse(req)
        resp.add_answer(req.name, dns.TYPE_A, 300, b'\xc0\xa8\x04\x01')  # 192.168.4.1的字节形式
        return resp.pack()
    return b''

HTTP服务器处理/generate_204的示例：

def handle_request(client):
    request = client.recv(1024).decode()
    if 'GET /generate_204' in request:
        # 重定向到交互页面
        response = 'HTTP/1.1 302 Found\r\nLocation: http://192.168.4.1/\r\nContent-Length: 0\r\n\r\n'
        client.send(response.encode())
    elif 'GET /' in request:
        # 返回你的交互页面内容
        response = 'HTTP/1.1 200 OK\r\nContent-Type: text/html\r\n\r\n' + open('index.html').read()
        client.send(response.encode())
    client.close()

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