ESP8266断电后LED控制失效，咨询是否需重复上传init.lua及问题原因

云原生阿岚

2026-5-15

问题：ESP8266断电后LED控制失效，是否每次都需重新上传代码？

我正在基于ESP8266开发LED控制功能，通过Android应用实现远程控制，开发过程参考了Random Nerd Tutorials的内容。使用的Lua代码如下：

wifi.setmode(wifi.STATION) 
wifi.sta.config("YOUR_NETWORK_NAME","YOUR_NETWORK_PASSWORD") 
print(wifi.sta.getip()) 
led1 = 3 
led2 = 4 
gpio.mode(led1, gpio.OUTPUT) 
gpio.mode(led2, gpio.OUTPUT) 
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+)&amp;*") do _GET[k] = v end 
end 
if(_GET.pin == "ON1")then gpio.write(led1, gpio.HIGH); 
elseif(_GET.pin == "OFF1")then gpio.write(led1, gpio.LOW); 
elseif(_GET.pin == "ON2")then gpio.write(led2, gpio.HIGH); 
elseif(_GET.pin == "OFF2")then gpio.write(led2, gpio.LOW); 
end 
client:send(buf); client:close(); collectgarbage(); 
end) 
end)

代码无语法错误，硬件接线也正常。通过ESPlorer将代码保存为init.lua上传至ESP8266后，当天可以正常通过Android应用控制LED，但次日断电重启后控制失效。请问是否每次给ESP8266断电后都需要重新上传代码？该问题的可能原因是什么？

回答

首先明确说：完全不需要每次断电都重新上传代码——ESP8266的Flash存储就是用来持久化代码的，只要正确写入，重启后会自动加载运行。你的问题大概率是代码没有被正确持久化，或者存在其他运行环境的问题，下面是具体的排查方向：

代码未真正写入Flash存储
很多新手在ESPlorer里容易犯这个错：只是在控制台执行了代码（临时运行），而没有把代码写入Flash的init.lua文件。你需要确认在ESPlorer中是用「Save to Flash」功能保存的代码，而不是仅仅点击「Run」按钮。也可以在ESPlorer的控制台输入file.list()命令，查看根目录下是否存在init.lua文件，如果没有，说明代码根本没被保存。
Flash存储写入故障或损坏
ESP8266的Flash偶尔会出现写入不完整或者坏块的情况，导致init.lua文件损坏。你可以先在控制台执行file.format()命令格式化Flash（注意会清空所有文件），然后重新上传init.lua，再重启设备测试。
Wi-Fi连接未自动恢复
你的代码里没有处理Wi-Fi重连逻辑，如果设备断电重启后，Wi-Fi信号不稳定或者网络有变动（比如路由器重启、SSID/密码变更），ESP8266可能无法自动重新连接到网络，导致Android app无法通信。可以给代码加个定时检查重连的逻辑，比如：
```
-- 添加Wi-Fi重连定时器
tmr.alarm(0, 5000, tmr.ALARM_AUTO, function()
  if wifi.sta.getip() == nil then
    print("Connecting to Wi-Fi...")
    wifi.sta.config("YOUR_NETWORK_NAME","YOUR_NETWORK_PASSWORD")
  end
end)
```
这样设备会每隔5秒检查一次Wi-Fi连接状态，没连接上就自动重试。
电源稳定性问题
ESP8266在启动和运行时需要稳定的5V/1A电源，如果电源功率不足或者电压波动大，可能导致设备重启后无法正常加载代码，或者Wi-Fi模块工作异常。建议换一个质量可靠的电源适配器，避免用电脑USB口供电（部分USB口功率不足）。
init.lua文件加载优先级问题
确认你的文件确实命名为init.lua，并且存放在ESP8266的根目录下——ESP8266启动时只会自动执行根目录的init.lua，如果文件名拼写错误（比如写成init.LUA）或者放在子目录里，设备重启后不会加载代码。

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