基于ESP8266 WiFi库的双模块客户端-服务器连接故障排查

服务器代码问题及修正 #

核心问题点 #

• 网关配置错误：SoftAP本地IP为192.168.0.1，但网关设为192.168.4.9，两者不在同一网段，直接导致客户端无法正常连接服务器。网关需与本地IP同网段，建议改为192.168.0.1。
• 赋值运算符误用：代码中用laststate == 1（比较运算符）替代laststate = 1（赋值运算符），导致按钮状态标记永远无法更新。
• 按钮检测逻辑混乱：嵌套while循环导致按钮松开时的逻辑无法触发，应改为在主循环中检测按钮状态变化，而非嵌套层级的循环结构。
• 引脚未初始化：未将按钮引脚设置为输入模式，ESP8266引脚默认状态不确定，必须显式初始化。
• 客户端连接处理不当：每次循环重新创建WiFiClient对象，且连接后的逻辑嵌套错误，导致状态检测代码无法正常执行。

修正后的服务器代码 #

#include <ESP8266WiFi.h>

IPAddress local_IP(192, 168, 0, 1);
IPAddress gateway(192, 168, 0, 1);  // 修正为同网段网关
IPAddress subnet(255, 255, 255, 0);
WiFiServer server(80);
WiFiClient client;  // 全局客户端对象，避免重复创建
int lastState = 0;
const int buttonPin = 1;  // 注意：GPIO1是TX引脚，硬件连接需避免串口冲突

void setup() {
  pinMode(buttonPin, INPUT_PULLUP);  // 初始化按钮引脚为上拉输入
  WiFi.softAPConfig(local_IP, gateway, subnet);
  WiFi.softAP("Button");
  server.begin();
}

void loop() {
  // 检查并获取新客户端连接
  if (!client.connected()) {
    client = server.available();
  }

  if (client.connected()) {
    int currentState = digitalRead(buttonPin);
    // 检测按钮状态变化（根据硬件连接调整高低电平判断逻辑）
    if (currentState != lastState) {
      if (currentState == HIGH) {
        client.print("1");  // 发送字符'1'，避免换行符干扰客户端解析
        lastState = HIGH;
      } else {
        client.print("0");
        lastState = LOW;
      }
      delay(50);  // 按键消抖
    }

    // 清理客户端发送的冗余数据
    while (client.available()) {
      client.read();
    }
  }
}

客户端代码问题及修正 #

核心问题点 #

• 未等待WiFi连接成功：调用WiFi.begin后直接尝试连接服务器，此时WiFi可能未完成连接，导致连接失败。
• 无重连机制：若客户端与服务器断开，没有自动重连逻辑，会一直处于离线状态。
• 数据读取判断错误：服务器发送的是字符'1'（ASCII码49），但客户端判断client.read() == 1，永远无法匹配，应判断是否等于'1'或49。
• 引脚未初始化：未将控制引脚设置为输出模式，无法正常驱动外部设备。
• 数据读取逻辑缺陷：while (client.read() == '1')会持续读取数据，导致单次数据被跳过，且未处理无数据的情况（返回-1）。

修正后的客户端代码 #

#include <ESP8266WiFi.h>

WiFiClient client;
const char* ssid = "Button";
const char* serverIP = "192.168.0.1";
const int serverPort = 80;
const int outputPin = 1;  // 注意：GPIO1是TX引脚，硬件连接需避免串口冲突

void setup() {
  pinMode(outputPin, OUTPUT);  // 初始化输出引脚
  WiFi.begin(ssid);
  // 等待WiFi连接成功
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
  }
}

void loop() {
  // 断开后自动重连服务器
  if (!client.connected()) {
    client.connect(serverIP, serverPort);
    delay(100);
  }

  if (client.available()) {
    char received = client.read();
    if (received == '1') {
      digitalWrite(outputPin, HIGH);
    } else if (received == '0') {
      digitalWrite(outputPin, LOW);
    }
  }
}

额外注意事项 #

• ESP8266的GPIO1（引脚1）为TX串口引脚，使用该引脚可能与串口输出冲突，建议更换为空闲引脚（如D2/GPIO4、D4/GPIO2）。
• 按钮硬件连接需匹配引脚模式：若使用INPUT_PULLUP，按钮应一端接引脚、另一端接地；若使用普通INPUT模式，需外接上拉/下拉电阻。

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