1. 方案整体设计与选型思路1.1 为什么用ESP32做主控而不是其他板子一开始选主控的时候我手上其实有好几种选择比如树莓派、Arduino UNO、还有几块STM32的板子。但最后定下来用ESP32主要原因就一个词——集成度。ESP32芯片自带2.4GHz WiFi和蓝牙双模也就是说我需要联网获取数据这一步不需要再外挂一个WiFi模块省掉了一堆接线和调试的麻烦。而且它双核240MHz的主频跑个网络请求、解析一下JSON、再通过串口把文本丢给TTS芯片性能绰绰有余。还有一个比较现实的原因就是成本。一块ESP32开发板现在的价格也就十几二十块比树莓派便宜一个数量级而且功耗低做长期在线的语音通知终端很合适。我实测过ESP32在WiFi连接状态下平均电流大概在80mA到120mA之间波动用个5V/2A的电源适配器供电绰绰有余。如果后续想做成电池供电的移动版本还可以利用它的深度睡眠模式需要播报的时候再唤醒。另外ESP32的生态现在非常成熟。Arduino IDE、ESP-IDF、PlatformIO各种开发方式都有人维护社区里踩过的坑基本都能搜到答案。这一点对快速出原型来说太重要了不然光配环境就能耗掉一整天。1.2 WT3000TX TTS模块解决了什么问题在没有用TTS模块之前我试过几种方案。第一种是ESP32自己解码播放预录的音频文件也就是把常用提示语提前录好存到SD卡或者Flash里播放的时候读出来。这个方案的问题很明显——不能播报动态内容。比如我想让它播报“当前温度26.3度湿度58%”这个26.3和58是实时变化的预录的音频根本覆盖不了无限种组合。第二种方案是用ESP32跑一个轻量级的TTS算法本地合成语音。这个方案我也试过效果不太理想。ESP32的内存和算力虽然不差但跑一个像样的神经网络TTS模型还是太吃力了合成出来的声音机械感很重而且延迟高有时候要等两三秒才出声音。像Coqui TTS这类方案更适合在树莓派或者PC上跑放到ESP32上就有点小马拉大车了。WT3000TX这类TTS芯片的思路就不一样——它把语音合成的工作全部交给专用芯片处理ESP32只负责通过串口发送文本字符串。芯片内部有自己的语音库和合成算法收到文本后直接输出模拟音频信号接上功放和喇叭就能出声。这样做的好处是主控的负担极小代码里就几行串口发送的语句而且合成速度很快实测从发送文本到开始出声延迟大概在200毫秒左右基本感觉不到等待。WT3000TX支持中文和英文混合合成内置了多种发音人可以通过串口命令切换。它支持UART通信波特率默认9600也可以配置成115200。供电范围宽3.3V和5V都能工作和ESP32的3.3V串口电平直接对接就行不需要额外的电平转换电路。这些特性组合起来让它成了ESP32语音通知方案里比较省心的搭配。1.3 整体链路是怎么跑通的把整个方案的链路拆开来看其实就四步第一步ESP32通过WiFi连接到局域网从指定的数据源获取信息。这个数据源可以是局域网内的一个HTTP接口也可以是公网上的天气API、消息推送接口等等。获取到的数据格式通常是JSON或者纯文本。第二步ESP32对拿到的数据进行解析和组装提取出需要播报的内容拼成一段自然语言的字符串。比如把{temp:26.3,hum:58}拼成“当前温度26.3度湿度58%”。第三步ESP32通过UART串口按照WT3000TX的通信协议把这段文本发送给TTS芯片。第四步WT3000TX收到文本后合成语音通过DAC输出模拟音频信号经过功放放大后推动喇叭发声。这四步里第一步和第三步是最容易出问题的环节。WiFi连接不稳定会导致数据拿不到串口通信的协议格式不对会导致TTS芯片没反应。后面的章节我会把这两个环节的细节掰开讲清楚。提示整个方案的核心思想是“分工”——ESP32只管联网和逻辑控制WT3000TX只管语音合成。不要把两边的任务混在一起否则调试起来会非常痛苦。2. 硬件准备与接线要点2.1 核心器件清单与选型建议这套方案用到的器件不多但每一样都有一些选型上的讲究。我把自己用的清单和选型理由列在下面器件型号/规格选型说明主控板ESP32-DevKitC或同等级开发板建议选带USB转串口芯片的版本烧录方便TTS模块WT3000TX支持UART控制中文合成效果自然功放模块PAM8403或LM386PAM8403效率高适合5V供电音质够用喇叭4欧3W或8欧1W4欧3W声音更大8欧1W功耗更低电源5V/2A直流适配器电流留足余量避免播报时电压跌落杜邦线母对母若干接线用建议用不同颜色区分ESP32开发板的选择上我建议优先选带外部天线接口的版本比如ESP32-WROOM-32U。虽然板载天线在大多数室内环境下也够用但如果你要把设备放在墙角或者金属机箱里外接天线能明显改善信号质量。我自己一开始用的是板载天线的版本放在书房角落的时候信号强度只有-75dBm左右后来换成外接天线直接提升到-55dBm连接稳定性好了很多。WT3000TX模块在购买的时候要注意有些商家卖的是裸芯片需要自己画板子焊接有些卖的是已经做成小模块的版本引脚已经引出直接插杜邦线就能用。对于快速验证来说肯定选模块版。另外要确认模块的串口电平是3.3V还是5V虽然大多数WT3000TX模块都兼容3.3V但最好跟卖家确认一下避免电平不匹配烧坏芯片。2.2 ESP32与WT3000TX的串口连接接线这部分看起来简单但有几个细节不注意就会导致通信失败。先看接线表ESP32引脚WT3000TX引脚说明GPIO17 (TX)RXESP32发送TTS接收GPIO16 (RX)TXESP32接收TTS发送GNDGND共地必须接3.3VVCC供电确认模块电压这里最需要注意的是TX和RX要交叉连接。ESP32的TX要接WT3000TX的RXESP32的RX要接WT3000TX的TX。我见过不少人直接TX对TX、RX对RX接然后纳闷为什么没反应。这个原理其实很好理解——发送端要对着接收端就像两个人说话一个人的嘴对着另一个人的耳朵不能嘴对嘴。另外ESP32上有很多个GPIO都可以用作串口我选GPIO16和GPIO17是因为这两个引脚在大多数开发板上都引出来了而且不占用默认的下载串口。ESP32默认的UART0是GPIO1和GPIO3这两个引脚在烧录和串口监视器上要用如果拿来接TTS模块会跟下载功能冲突。所以一定要用第二组或者第三组硬件串口通过HardwareSerial库来映射引脚。共地这一条我想单独强调一下。如果ESP32和WT3000TX不共地串口信号就没有参考电平通信会时好时坏甚至完全不通。我有一次调试的时候忘了接GND结果ESP32发送的数据TTS芯片偶尔能收到偶尔收不到排查了半天才想起来是地线没接。2.3 供电与音频输出的处理供电这块WT3000TX和功放模块都对电源质量比较敏感。WT3000TX在合成语音的瞬间电流会有波动如果电源供应不足会导致芯片复位或者发出“咔咔”的杂音。我的做法是给WT3000TX单独走一路电源滤波在模块的VCC和GND之间并一个100微法的电解电容和一个0.1微法的陶瓷电容前者滤低频波动后者滤高频噪声。功放模块PAM8403的供电是5V它的输出接喇叭。PAM8403是D类功放效率很高但输出是PWM调制的方式如果喇叭线太长或者走线不合理可能会对WiFi信号产生干扰。我实测下来喇叭线控制在20厘米以内并且远离ESP32的天线区域基本上不会有明显影响。音频输出的接线是这样的WT3000TX的音频输出引脚通常是DAC_OUT或者SPK、SPK-接到功放模块的输入端功放模块的输出端接喇叭。如果WT3000TX模块自带功放那就更简单了直接把喇叭接到模块的喇叭接口上就行。不过自带功放的模块功率一般比较小声音不大适合桌面近距离使用。如果想要更大音量还是外接一个独立的功放模块更靠谱。注意在通电之前一定要用万用表确认一下电源电压和极性。我有个朋友把5V电源正负极接反了直接烧掉了WT3000TX模块几十块钱就这么没了。2.4 结构安装与散热考虑如果只是临时验证面包板插一插就行了。但如果要长期运行建议还是焊接到洞洞板或者打个PCB上。长期用杜邦线连接的话震动或者氧化会导致接触不良故障率很高。散热方面ESP32和WT3000TX的发热量都不大正常室温下不需要额外加散热片。但如果把整个装置塞进密闭的塑料盒里夏天的时候内部温度可能会到五六十度这时候最好在盒子上开几个通风孔或者加一个小风扇。我自己做的一个版本放在阳台夏天暴晒下盒子内部温度到了65度ESP32虽然还能工作但WiFi连接偶尔会断后来加了通风孔之后就稳定了。3. ESP32端程序开发与WiFi接入3.1 开发环境搭建与基础配置开发环境我用的是Arduino IDE主要是因为它上手快库管理方便。如果你更习惯ESP-IDF那也没问题逻辑是一样的只是API调用方式不同。Arduino IDE的安装这里不展开说了重点讲几个ESP32开发板的配置要点。安装ESP32支持包的时候在“开发板管理器”里搜索“esp32”安装Espressif Systems提供的那个包。安装完成之后在“开发板”菜单里选择“ESP32 Dev Module”。有几个参数需要特别注意Flash Size根据你的开发板实际Flash大小选择一般是4MBUpload Speed建议设为921600烧录速度快Partition Scheme默认的Default 4MB with spiffs就行PSRAM如果你的板子带PSRAM可以开启但这个项目用不到库的依赖方面需要用到WiFi.hESP32自带和HTTPClient.hESP32自带以及ArduinoJson库需要额外安装。TTS部分不需要额外的库直接用HardwareSerial发字符串就行。装好环境之后先烧一个最简单的WiFi扫描程序验证一下板子和WiFi功能是否正常。代码如下#include WiFi.h void setup() { Serial.begin(115200); WiFi.mode(WIFI_STA); WiFi.disconnect(); delay(100); Serial.println(扫描附近WiFi网络...); int n WiFi.scanNetworks(); Serial.println(扫描完成); for (int i 0; i n; i) { Serial.print(i 1); Serial.print(: ); Serial.print(WiFi.SSID(i)); Serial.print( (信号强度: ); Serial.print(WiFi.RSSI(i)); Serial.println()); } } void loop() {}这段代码跑通之后能看到附近WiFi的列表和信号强度说明ESP32的WiFi功能正常。如果这一步就有问题后面的都不用做了先检查板子和USB线。3.2 WiFi连接与数据获取的稳定策略WiFi连接本身很简单调WiFi.begin(ssid, password)然后等连接成功就行了。但实际用起来最大的问题是断线重连。我一开始的代码没做重连处理结果路由器重启或者信号波动之后ESP32就永远卡在断线状态语音通知自然也就断了。后来我加了一个连接状态检查机制在loop()里定期检查WiFi状态如果发现断开了就重新连接。核心逻辑是这样#include WiFi.h #include HTTPClient.h #include ArduinoJson.h const char* ssid 你的WiFi名称; const char* password 你的WiFi密码; unsigned long lastCheck 0; const unsigned long checkInterval 10000; // 10秒检查一次 void ensureWiFiConnected() { if (WiFi.status() WL_CONNECTED) return; Serial.println(WiFi已断开尝试重连...); WiFi.disconnect(); WiFi.begin(ssid, password); unsigned long start millis(); while (WiFi.status() ! WL_CONNECTED millis() - start 15000) { delay(500); Serial.print(.); } if (WiFi.status() WL_CONNECTED) { Serial.println(\n重连成功IP地址: WiFi.localIP().toString()); } else { Serial.println(\n重连失败下次循环再试); } }这个重连逻辑里有个细节值得说我加了15秒的超时限制。如果不加超时while循环在信号极差的情况下可能会卡很久导致整个程序失去响应。加了超时之后即使这次没连上也会先退出来保证程序能继续跑其他逻辑过一会儿再重试。数据获取这块我用的是HTTP GET请求。假设局域网里有个服务端提供了温湿度数据接口返回JSON格式String fetchData() { if (WiFi.status() ! WL_CONNECTED) return ; HTTPClient http; http.begin(http://192.168.1.100:8080/api/sensor); int httpCode http.GET(); String result ; if (httpCode 200) { result http.getString(); Serial.println(获取数据成功: result); } else { Serial.println(请求失败状态码: String(httpCode)); } http.end(); return result; }这里的IP地址和端口根据你的实际服务端来改。如果是从公网API获取数据比如天气接口把URL换成对应的地址就行。注意HTTPClient默认的超时时间比较短如果服务端响应慢可以在http.begin()之后调http.setTimeout(5000)把超时设长一点。3.3 串口通信与TTS文本下发串口这块前面说了要用第二组硬件串口。在Arduino里定义方式如下HardwareSerial TTS_SERIAL(2); // 使用UART2 void setupTTS() { TTS_SERIAL.begin(9600, SERIAL_8N1, 16, 17); // RX16, TX17 delay(500); // 等TTS模块初始化 }波特率9600是WT3000TX的默认值如果你的模块改过波特率这里也要对应改。SERIAL_8N1是8位数据位、无校验、1位停止位这是最常见的串口配置。WT3000TX的文本播报命令格式根据我查到的资料和实测一般是这样的帧结构字节位置内容说明00xFD帧头1长度高字节数据长度2长度低字节数据长度30x01命令字文本播报40x00参数5~N文本内容UTF-8或GBK编码N1~N2校验和累加校验不过不同批次的WT3000TX固件版本协议可能略有差异。最稳妥的办法是找卖家要一份对应批次的通信协议手册或者用串口调试助手先手动发几条命令测试一下确认格式无误之后再写到代码里。发送文本的代码大概长这样void speakText(String text) { // 假设协议FD 长度 01 00 文本 int len text.length(); uint8_t header[5]; header[0] 0xFD; header[1] (len 2) 8; header[2] (len 2) 0xFF; header[3] 0x01; header[4] 0x00; TTS_SERIAL.write(header, 5); TTS_SERIAL.print(text); TTS_SERIAL.flush(); Serial.println(已下发TTS文本: text); }这段代码里TTS_SERIAL.flush()的作用是等待串口数据发送完成再返回避免文本还没发完就执行后面的逻辑。如果不加flush在快速连续发送多条文本的时候可能会出现数据截断。3.4 文本组装与播报调度逻辑拿到的JSON数据不能直接丢给TTS芯片因为TTS芯片只会照着文本念它不理解JSON。所以中间需要一层组装逻辑把结构化的数据拼成人能听懂的自然语言。比如拿到{temp:26.3,hum:58,time:14:30}要拼成“现在是14点30分当前温度26.3摄氏度湿度58%”。这个组装逻辑看起来简单但有几个细节要注意。第一数字的读法。26.3如果直接写成“26.3”TTS可能会念成“二十六点三”也可能念成“二十六三”不同固件行为不一样。稳妥的做法是手动拼成“二十六点三”或者“26度3”根据实际效果调整。第二单位的处理。“%”这个符号有些TTS会念成“百分号”有些会直接跳过最好写成“百分之58”。第三长文本要分段。WT3000TX的串口缓冲区有限一次发送超过200个字节的文本可能会丢数据建议把长句拆成多个短句分次发送。我的一般做法是写一个组装函数把数据对象转成播报文本String buildSpeechText(float temp, float hum, String time) { String result 现在是 time 。; result 当前温度 String(temp, 1) 摄氏度。; result 湿度百分之 String((int)hum) 。; return result; }播报调度方面我设了一个定时机制每隔一段时间比如半小时自动播报一次同时也支持通过串口或者HTTP请求手动触发播报。定时用millis()做非阻塞延时不要用delay()否则整个程序会卡住。4. TTS播报核心实现与文本优化4.1 WT3000TX通信协议的关键参数前面提到了WT3000TX的帧格式这里再深入讲几个实际调试中发现的细节。首先是文本编码。WT3000TX大多数版本默认支持GBK编码也有部分版本支持UTF-8。如果你的代码里用的是UTF-8字符串但模块只认GBK那播报出来的就是乱码或者干脆不发声。确认编码的方法是先用串口调试助手手动发一串GBK编码的中文过去看能不能正常播报。如果不确定可以问卖家要模块的说明文档。其次是命令字。除了文本播报命令一般是0x01WT3000TX还支持设置音量、设置语速、设置发音人、停止播报等命令。这些命令的格式和文本播报类似只是命令字不同。我常用的几个命令是功能命令字参数说明文本播报0x01后跟文本内容停止播报0x02无参数设置音量0x03参数0~10设置语速0x04参数0~10切换发音人0x05参数0~5这些命令字的具体数值可能因固件版本不同而有差异以你手头模块的文档为准。我一般是把常用的命令封装成函数需要的时候调用。4.2 播报文本的清洗与分句策略文本清洗这一步很多人会忽略但它直接决定了播报效果好不好听。我踩过的坑包括JSON里有多余的空格和换行符TTS念出来会停顿很奇怪数字格式不统一有时候念“二十六点三”有时候念“二六点三”特殊符号比如括号、引号TTS有的会念出来有的不会。我的清洗流程是这样的第一步去掉所有非中文字符、非数字、非必要标点之外的字符。用正则或者简单的字符过滤都行。第二步把阿拉伯数字转成中文读法。比如“26.3”转成“二十六点三”“58”转成“五十八”。这个转换函数需要自己写处理整数部分和小数部分。第三步把符号转成文字。比如“%”转成“百分之”“℃”转成“摄氏度”“”转成“度”。第四步分句。按照句号、问号、感叹号把长文本拆成短句每句不超过50个字符分次发送给TTS芯片。这里有个经验TTS播报的节奏感很重要。如果一句话太长听起来会很累如果每句太短又显得断断续续。我的习惯是每句控制在15到30个字之间句号、逗号、顿号交替使用让语音有自然的起伏。4.3 音量、语速与发音人的现场调节WT3000TX的默认音量和语速是中等偏慢的听起来有点像新闻播音员的速度用于通知提醒稍微有点拖沓。我一般会把语速调到7或者8满值10音量调到8发音人选择比较清晰明亮的那一个。调节的方法就是发送对应的命令帧。比如设置音量为8void setVolume(uint8_t vol) { uint8_t cmd[6] {0xFD, 0x00, 0x03, 0x03, vol, 0x00}; // 校验和计算略 TTS_SERIAL.write(cmd, 6); TTS_SERIAL.flush(); }语速调节的命令字和音量不同但格式类似。我建议在实际环境中边调边听找到最舒服的组合。比如在安静的卧室里音量6就够了在嘈杂的客厅或者办公室音量要开到9甚至10。语速的话如果是紧急通知可以调到9或者10听起来更抓注意力如果是常规播报7左右比较自然。发音人切换方面WT3000TX一般内置了男声、女声、童声几种。我实测下来女声比较适合做通知播报清晰度高男声适合做长文本朗读听起来不累。如果你需要播报英文内容还要确认所选发音人支持英文合成。提示调节参数的时候建议先发停止播报命令再发新的设置命令最后发文本。否则前一秒还在播报的时候改参数可能会出现声音突然变调的情况。4.4 播报触发方式的设计触发播报的方式我设计了三种覆盖不同的使用场景第一种是定时触发。比如每隔半小时播报一次当前温湿度或者每天早上7点播报天气和日程。这个用millis()做时间判断或者接一个RTC模块获取准确时间。第二种是串口触发。通过ESP32的USB串口发送特定指令比如发送“speak:hello”就播报“hello”。这个方式适合手动测试和临时通知。第三种是网络触发。ESP32开一个简单的HTTP服务端监听某个端口收到请求就播报指定内容。这个方式适合和其他系统集成比如电脑上检测到重要邮件就发个请求让ESP32播报“您有新邮件”。#include WebServer.h WebServer server(80); void handleSpeak() { String text server.arg(text); if (text.length() 0) { speakText(text); server.send(200, text/plain, OK); } else { server.send(400, text/plain, missing text); } } void setupServer() { server.on(/speak, handleSpeak); server.begin(); }然后在loop()里调server.handleClient()就行了。这个HTTP服务端很简单但足够用。注意ESP32的HTTP服务端是单线程的如果同时来多个请求可能会丢对于语音通知这种低频场景来说问题不大。5. 完整实操流程与现场记录5.1 从零搭建的步骤清单我把整个搭建过程按顺序列出来你可以照着一步步做准备硬件ESP32开发板、WT3000TX模块、功放、喇叭、电源、杜邦线。先不接线单独给ESP32烧一个点灯程序确认板子正常。连接WiFi并测试烧录WiFi扫描程序确认能搜到你的网络再烧录连接程序确认能连上并获取IP地址。连接TTS模块按照TX-RX交叉、GND共地的原则接好线。先不接功放和喇叭用串口调试助手手动发一条文本播报命令确认模块能发声可以先用耳机接模块的音频输出听。联调ESP32和TTS把TTS发送代码集成到ESP32程序里通过串口监视器触发一次播报确认从ESP32发出的文本能被TTS正确合成。加入数据获取逻辑实现HTTP请求和JSON解析把拿到的数据组装成播报文本再发送给TTS。加入定时和重连机制实现WiFi断线重连、定时播报、HTTP触发播报等功能。整体测试连续运行几个小时观察是否有断线、死机、播报失败等问题。封装和安装把电路焊接到洞洞板或者PCB上装进盒子固定好喇叭和电源。这个顺序的核心逻辑是分步验证逐步集成。每一步都确认没问题了再做下一步这样出问题的时候容易定位。我最开始图省事一次性把所有代码都写好烧进去结果既没声音又不联网排查了一整天才发现是串口引脚定义写错了。5.2 联调过程中的实测记录联调的时候我记录了一些关键数据分享出来供参考测试项条件结果WiFi连接时间信号强度-55dBm约1.5秒连上WiFi连接时间信号强度-80dBm约6秒连上偶尔失败HTTP请求耗时局域网服务端平均80毫秒TTS合成延迟10字短句约200毫秒TTS合成延迟50字长句约500毫秒待机电流WiFi保持连接约90mA播报瞬间电流音量8峰值约250mA从这些数据可以看出几个问题。第一WiFi信号强度对连接时间影响很大-80dBm的时候连接明显变慢所以设备摆放位置很重要尽量靠近路由器或者用外接天线。第二TTS的合成延迟和文本长度成正比长句子的延迟会明显增加所以分句播报不仅能避免缓冲区溢出还能降低响应延迟。第三播报瞬间的电流峰值是待机的三倍左右电源的电流余量一定要留够不然播报的时候电压跌落会导致ESP32复位。5.3 连续运行稳定性优化连续运行了大概一周之后我发现了一些偶发问题。一个是ESP32偶尔会死机表现为WiFi断连后不再重连串口也没输出。查资料之后发现是ESP32的看门狗在某些情况下会误触发解决方法是定期喂狗或者直接关闭看门狗。我用的是esp_task_wdt_reset()定期重置看门狗同时在loop()里避免长时间的阻塞操作。另一个问题是TTS模块偶尔会不响应。排查后发现是串口数据发送太快模块的缓冲区处理不过来。解决方法是在每次发送文本之后加一个短延时比如delay(50)给模块一点处理时间。另外如果连续发送多条文本最好等上一条播报完成之后再发下一条可以通过查询模块的忙状态引脚或者简单估算播报时长来延时。还有一个是内存泄漏的问题。ESP32长时间运行后可用堆内存会逐渐减少。我用ESP.getFreeHeap()定期打印内存使用情况发现是HTTPClient或者String对象没有及时释放导致的。解决方法是把String换成固定长度的char数组或者在每次HTTP请求结束后手动调http.end()和清理临时对象。经过这些优化之后设备连续运行了三个多月没有出现死机或者播报失败的情况。当然定期重启也是一个简单有效的保底手段我设置了每天凌晨4点自动重启一次进一步降低了偶发故障的概率。6. 常见问题与排查技巧实录6.1 硬件类问题速查硬件问题是最容易让人抓狂的因为代码看起来没问题但就是没反应。我把遇到过的情况整理成表格现象可能原因排查方法上电后完全没声音供电不足或接线错误万用表测各点电压确认GND共地声音断断续续有杂音电源滤波不足VCC和GND间并联100微法电容喇叭有电流声但无语音TTS模块未收到数据检查TX-RX是否交叉串口波特率播报声音很小功放增益不够或喇叭阻抗不匹配换4欧喇叭或调大TTS音量ESP32频繁复位电源电流不足换5V/2A以上电源加滤波电容WiFi信号差天线位置不佳或有遮挡改用外接天线调整设备位置这里重点说一个我踩过的坑功放模块的输入阻抗。PAM8403的输入阻抗是10k欧如果WT3000TX的音频输出阻抗也很高直接连接会导致信号衰减严重声音很小。解决方法是加一个10k欧的电位器做阻抗匹配或者换一个输入阻抗更高的功放模块。我一开始不知道这个接上去声音小得跟蚊子叫一样后来加了个电位器才正常。6.2 软件类问题速查软件问题相对好排查因为串口有日志输出。常见的情况有现象可能原因解决思路WiFi连不上SSID或密码错误检查代码里的账号密码注意大小写WiFi频繁断开信号弱或路由器问题加断线重连逻辑检查路由器设置HTTP请求失败URL错误或服务端不可达用浏览器先访问URL确认服务可用JSON解析失败数据格式不符合预期打印原始数据检查字段名和类型串口无输出波特率不匹配确认串口监视器和代码里的波特率一致TTS不发声协议格式错误用串口调试助手手动发命令测试JSON解析这里有个细节。ArduinoJson库对内存要求比较高如果JSON文档很大需要预先分配足够的内存。我一般用DynamicJsonDocument doc(1024)分配1KB的内存对于大多数传感器数据来说足够了。如果解析失败先检查一下内存分配够不够。6.3 音频与播报类问题速查音频类问题的表现比较多样排查起来需要一些耐心现象可能原因解决思路播报内容有错别字音文本编码不匹配确认模块支持UTF-8还是GBK数字读法不对TTS对数字解析不一致手动转成中文读法再发送长句播报被截断串口缓冲区溢出分句发送每句不超过50字播报中途突然停止电源波动导致模块复位加滤波电容检查电源功率语音机械感重语速或发音人设置不当调整语速到7左右换发音人播报延迟大文本太长或串口慢缩短文本提高波特率到115200关于文本编码我补充一个判断方法发送“你好”两个字。如果播报出来是正常的“你好”说明编码匹配如果播报出来是乱码或者不发声说明编码不匹配。GBK编码的“你好”是两个字节C4 E3 BA C3UTF-8编码的“你好”是六个字节E4 BD A0 E5 A5 BD。用串口调试助手的十六进制模式发这两种格式看哪种能正常播报就知道了。6.4 独家避坑经验汇总最后分享几个文档里不会写、但实际调试中非常重要的经验第一先让TTS独立工作再和ESP32联调。我见过太多人一上来就把ESP32和TTS接在一起结果出了问题不知道是ESP32的代码问题还是TTS的接线问题。正确的做法是先用手动串口调试助手把TTS调通确认模块能正常发声再把ESP32接上去。第二打印所有关键数据。调试阶段一定要把WiFi状态、IP地址、HTTP响应码、TTS发送的文本内容都通过串口打印出来。我一般用Serial.println()在关键节点加日志出问题的时候一看日志就知道卡在哪一步了。第三电源一定要单独测试。不要用电脑的USB口给整个系统供电电脑USB口的电流限制一般是500mA而ESP32加TTS加功放播报时的峰值电流可能超过这个值。用独立的5V/2A电源适配器能避免很多莫名其妙的复位和杂音问题。第四播报内容要有人情味。纯数据播报听起来很生硬比如“温度26.3湿度58”就不如“当前温度二十六点三度湿度百分之五十八体感比较舒适”。加一些描述性的词语让语音通知听起来更自然这也是TTS方案相比蜂鸣器报警的优势所在。第五留一个手动触发按钮。在设备上接一个轻触按钮接到ESP32的某个GPIO上按下就触发一次播报。这个按钮在调试和日常使用中都很方便不用每次都打开手机或者电脑发请求。这套方案我从最初的想法到最终稳定运行前前后后花了大概两周的业余时间中间踩了不少坑但整体来说ESP32加WT3000TX的组合算是比较容易上手的。如果你手头正好有这两样东西不妨照着这个思路试一试从最简单的点灯和串口通信开始一步步把功能堆上去。等你听到第一句从自己搭的电路里发出来的语音时那种成就感还是挺不错的。