ESP8266不同NodeMCU固件版本HTTP无响应问题排查咨询

使用旧版NodeMCU固件（0.9.5 build 20150318，基于Lua 5.1.4）时，ESP8266可正常向手机返回HTTP响应；但使用新版固件（2022-09-07版本，基于SDK 3.0.1-dev(fce080e)的Lua 5.1.4）时，ESP8266虽能收到“who”请求，却无法向手机返回响应。

代码示例 #

srv = net.createServer(net.TCP)
srv:listen(80,function(conn)
  conn:on("receive", function(client,request)
    local buf = "";
    buf = buf.."HTTP/1.1 200 OK\n\n"
    local _, _, method, path, vars = string.find(request, "([A-Z]+) (.+)?(.+) HTTP");
    if(method == nil)then
        _, _, method, path = string.find(request, "([A-Z]+) (.+) HTTP");
    end
    
    local _GET = {}
    if (vars ~= nil)then
        for k, v in string.gmatch(vars, "(%w+)=(%w+)&*") do
           _GET[k] = v
        end
    end
    
    if(_GET.pin == "ON1")then
        print("On")
    elseif(_GET.pin == "OFF1") then
        print("Off")
    end
    
    if(_GET.question == "who") then
        buf=""
        buf = buf.."HTTP/1.1 200 OK\n\n"
        print(buf)
    end
    
    client:send(buf)
    client:close()
    collectgarbage()
    end) 
 end)

可能的原因及解决方法 #

1. 异步发送未完成即关闭连接 #

新版NodeMCU的client:send()是异步执行的，调用后不会等待数据发送完成就继续执行后续代码。原代码中直接在send后调用client:close()，会导致连接提前关闭，数据无法完整发送到客户端。

解决方法：在send的回调函数中执行关闭操作，确保数据发送完成：

client:send(buf, function()
    client:close()
    collectgarbage()
end)

2. HTTP响应格式不规范 #

旧版固件对不标准的HTTP响应兼容性较强，而新版固件（基于SDK 3.0）对响应格式要求更严格。原响应仅包含状态行，缺少必要的HTTP头部（如Content-Type、Content-Length），客户端无法正确识别响应结束，导致看起来没有收到响应。

解决方法：完善HTTP响应格式，添加必要的头部信息：

-- 以"who"请求的响应为例
if(_GET.question == "who") then
    buf=""
    buf = buf.."HTTP/1.1 200 OK\r\n"
    buf = buf.."Content-Type: text/plain\r\n"
    buf = buf.."Content-Length: 0\r\n"  -- 若需返回内容，替换为实际长度
    buf = buf.."Connection: close\r\n\r\n"
    print(buf)
end

3. 字符串匹配逻辑的潜在问题 #

虽然你提到能收到请求，但新版Lua的正则匹配可能存在细微差异，导致_GET表的赋值出现异常。可以添加调试代码确认_GET.question是否正确获取到值：

-- 在处理请求后添加调试打印
print("_GET表内容:")
for k,v in pairs(_GET) do
    print(k .. "=" .. v)
end

4. 固件API的变更 #

新版NodeMCU的net模块API可能存在变更，比如conn:on("receive")的回调参数或行为变化。可以对照官方文档确认API兼容性，但前两点是最可能的原因。

内容的提问来源于stack exchange，提问作者Илья