ESP32无法向本地Django项目传输数据的排查求助

核心问题分析 #

ESP32请求返回错误码-1，说明TCP连接建立失败；而Postman本地测试正常、ESP32能连接外部API，排除ESP32网络模块和Django接口逻辑问题，问题集中在本地网络可达性或请求格式不匹配。

具体排查步骤 #

1. 修改Django监听地址 #

默认python manage.py runserver只绑定127.0.0.1，仅允许本地访问。ESP32作为局域网内的外部设备，无法访问这个地址。需要让Django监听所有网卡：

python manage.py runserver 0.0.0.0:8000

这样Django会响应局域网内所有设备的请求。

2. 检查电脑防火墙/安全软件 #

本地防火墙可能拦截了8000端口的入站请求：

• 临时关闭防火墙测试，若能成功连接，说明是防火墙拦截，需添加规则允许8000端口的TCP入站连接。
• 部分杀毒软件也会拦截未知端口的网络请求，可临时关闭测试。

3. 修正ESP32的URL格式 #

HTTPClient需要完整的URL（包含协议前缀），你的代码中serverAddress缺少http://，导致无法识别协议：

// 错误写法
const String serverAddress = "xxx.xxx.xxx.xxx:8000/suitcase/esp32_test";

// 正确写法
const String serverAddress = "http://xxx.xxx.xxx.xxx:8000/suitcase/esp32_test";

4. 匹配请求格式与Content-Type #

你设置的Content-Type是application/x-www-form-urlencoded，但发送的是JSON格式字符串，两者不匹配，Django无法解析，同时可能导致连接异常：

方案A：改用表单格式发送

修改ESP32的ExtractProxy和SendProxyToServer：

String ExtractProxy(String data){
    int commaIndex = data.indexOf(',');
    if (commaIndex != -1 && data.length() > commaIndex + 13) {
      String longitude = data.substring(commaIndex + 1, commaIndex + 10);
      String latitude = data.substring(commaIndex + 14, commaIndex + 24);
      // 返回表单格式字符串
      return "latitude=" + latitude + "&longitude=" + longitude;
    }else{
      return "";
    }
}

此方案不需要修改Django代码，request.POST可正常解析。

方案B：改用JSON格式发送

修改ESP32的请求头：

void SendProxyToServer(String proxy){
  if (WiFi.status() == WL_CONNECTED) {
    HTTPClient http;
    http.begin(serverAddress); 
    // 修改Content-Type为application/json
    http.addHeader("Content-Type", "application/json");
    Serial.println("check2");

    int httpResponseCode = http.POST(proxy);
    // ... 其余代码不变
  }
};

同时修改Django的esp32_test函数，解析JSON请求体：

import json
@csrf_exempt
def esp32_test(request):
    if request.method == 'POST':
        try:
            data = json.loads(request.body)
            longitude = data.get('longitude', '')
            latitude = data.get('latitude', '')
            print("Received data from ESP32:", data)
            return JsonResponse({'message': 'Data received successfully'})
        except json.JSONDecodeError:
            return JsonResponse({'error': 'Invalid JSON data'}, status=400)
    return JsonResponse({'error': 'Invalid request method'})

5. 确认电脑局域网IP正确性 #

确保ESP32代码中的xxx.xxx.xxx.xxx是电脑当前WiFi的局域网IP：

• Windows：运行ipconfig查看「无线局域网适配器 WLAN」下的IPv4地址。
• Linux/macOS：运行ifconfig或ip addr查看WiFi接口的inet地址。

验证步骤 #

1. 按上述修改后，重启Django服务。
2. 用ESP32重新发送请求，查看串口输出是否返回200。
3. 若仍失败，可在电脑上用ping [ESP32的IP]测试双向连通性。

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