ESP32 GPIO初始化异常：上电按键误判为短按的原因与解决

原因分析 #

1. 引脚电平不稳定/初始状态异常：ESP32的GPIO引脚默认是浮空状态，上电时容易出现电平波动；如果你的按键硬件电路没配置合适的上拉/下拉电阻，初始化阶段digitalRead(BUTTON)会返回非预期的高电平，触发pushed = 1。后续引脚电平回落时，又会触发released = 1，此时presscycles计数远小于BTN_LONGPRESS，因此被误判为短按。
2. 静态变量的持续影响：上电复位后静态变量虽会初始化为0，但如果初始化阶段引脚电平先高后低，第一次调用button_get时会设置pushed=1，第二次调用引脚变低就会设置released=1，这两个静态变量会保持该状态直到被手动重置。

具体解决方案 #

1. 正确配置按键引脚输入模式 #

根据按键硬件电路，在setup()函数中为引脚配置上拉或下拉：

• 若按键一端接GPIO、一端接地：使用pinMode(BUTTON, INPUT_PULLUP);，未按下时引脚为高电平，按下时为低电平。
• 若按键一端接GPIO、一端接VCC：使用pinMode(BUTTON, INPUT_PULLDOWN);，未按下时引脚为低电平，按下时为高电平。

2. 优化按键检测逻辑，增加上电初始化校准 #

修改button_get函数，加入上电状态校准和防抖处理，避免误触发：

enum input button_get(void) {
  #define BTN_LONGPRESS 500
  #define DEBOUNCE_DELAY 20  // 防抖延时，单位ms（需匹配函数调用间隔）
  static int presscycles = 0;
  static int released = 0;
  static int pushed = 0;
  static int initialized = 0;  // 新增：初始化完成标志

  // 上电第一次调用时校准初始状态
  if (!initialized) {
    delay(100);  // 等待引脚电平稳定
    int init_state = digitalRead(BUTTON);
    // 若初始状态为按下，直接标记为已触发过，避免上电误判
    pushed = init_state ? 1 : 0;
    released = 0;
    initialized = 1;
    return IN_NONE;
  }

  // 防抖处理：确认引脚状态稳定
  static int last_state = HIGH;
  int current_state = digitalRead(BUTTON);
  if (current_state != last_state) {
    delay(DEBOUNCE_DELAY);
    current_state = digitalRead(BUTTON);
    last_state = current_state;
  }

  if (current_state) {
    pushed = 1;
    released = 0;
    presscycles++;
  } else {
    if (pushed == 1)
      released = 1;
  }

  if (released == 1 && presscycles >= BTN_LONGPRESS) {
    released = 0;
    presscycles = 0;
    Serial.print("IN_REFILL\n");
    delay(3000);
    return IN_REFILL;
  } else if (released == 1 && presscycles > 0 && presscycles < BTN_LONGPRESS) {
    released = 0;
    presscycles = 0;
    Serial.print("IN_CLEAN\n");
    delay(3000);
    return IN_CLEAN;
  } else {
    return IN_NONE;
  }
}

3. 替换阻塞式delay（可选但推荐） #

原代码中的delay(3000)会阻塞整个程序，导致其他功能无法运行。建议改用基于millis()的非阻塞延时逻辑，通过主循环的状态机来处理后续操作，避免程序停滞。

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