ESP32部署本地AI唤醒的常见问题排查

昨天深夜在嵌入式爱好者群里蹲到三个连麦求助的新手，全是折腾ESP32跑本地轻量AI唤醒踩的坑，翻了下论坛收藏夹，类似的提问这周已经见了快二十条，索性把高频问题和对应排查步骤整理出来。

高频求助问题汇总

• 烧录完开源AI唤醒固件，喊唤醒词完全没反应，串口要么乱码要么没相关输出
• 按教程接了I2S麦克风模块，读出来的音频全是底噪，根本识别不到人声
• 好不容易能触发唤醒，旁边有人说话甚至开个风扇就误触发，调灵敏度没用

烧完固件喊唤醒词没反应

1. 先把ESP32拔插一次，打开串口监视器按一下开发板上的EN键，看启动日志如果全是乱码，别死磕教程里写的固定波特率，从921600往下逐个试，不同作者编译的固件默认波特率可能有区别。
2. 如果日志输出正常但喊唤醒词没反应，先在串口输入命令查看模型加载状态：

   get_model_status

   如果返回值为0就是没加载到唤醒模型，大概率是烧录的时候漏选了SPIFFS分区的bin文件，重新烧录时记得勾选对应文件，偏移地址一般填0x110000，别写错。

接了麦克风还是读不到人声

1. 先对照你用的开发板引脚定义核对接线，以常用的ESP32-WROOM-32搭配INMP441麦克风为例，VCC必须接3.3V（接5V会直接烧模块），GND接GND，SCK接GPIO26，WS接GPIO25，SD接GPIO33，模块上的L/R引脚直接接GND选左声道，不要悬空。
2. 接线没问题就跑下面的测试代码读音频幅值，正常说话的时候数值应该在1000-3000左右浮动，如果一直维持在几十或者几万的区间，就是引脚配置错了：

   #include 
   #define I2S_PORT I2S_NUM_0
   void setup() {
     Serial.begin(115200);
     i2s_config_t i2s_config = {
       .mode = (i2s_mode_t)(I2S_MODE_MASTER | I2S_MODE_RX),
       .sample_rate = 16000,
       .bits_per_sample = I2S_BITS_PER_SAMPLE_16BIT,
       .channel_format = I2S_CHANNEL_FMT_ONLY_LEFT,
       .communication_format = I2S_COMM_FORMAT_STAND_I2S,
       .intr_alloc_flags = ESP_INTR_FLAG_LEVEL1,
       .dma_buf_count = 8,
       .dma_buf_len = 64,
       .use_apll = false
     };
     i2s_driver_install(I2S_PORT, &i2s_config, 0, NULL);
     // 引脚号根据自己的实际接线修改
     i2s_set_pin(I2S_PORT, NULL, 33, 25, 26, -1);
   }
   void loop() {
     int16_t sample;
     size_t bytes_read;
     i2s_read(I2S_PORT, &sample, sizeof(sample), &bytes_read, portMAX_DELAY);
     Serial.println(abs(sample));
     delay(1);
   }

容易误触发调不好灵敏度

1. 别上来就拉满灵敏度阈值，先在代码里加串口打印唤醒时的置信度，清晰喊唤醒词的时候置信度大概在0.7-0.9左右，如果误触发时的置信度只有0.4-0.5，就把阈值调到0.6上下就行，拉到0.9以上反而会出现真喊没反应的情况。
2. 如果使用环境有持续低频噪音（比如新风、鱼缸水泵），可以录10秒左右的环境音作为负样本加到唤醒模型里重新训练生成，比光调阈值有用，常用的开源唤醒工具比如Snowflake、Edge Impulse都支持自定义负样本，操作门槛不高。

提醒一句：别用太长或者劣质的杜邦线接I2S麦克风，线阻大或者接触不良会导致音频数据丢包，看起来就跟没接麦克风一样，排查的时候先换10cm以内的优质杜邦线试试，能省不少时间。

对了，要是你调的时候碰到什么奇奇怪怪的问题，直接把完整串口日志贴到评论区就行，别上来就判定是硬件坏了，八成是哪根线接错或者参数填歪了。