宿舍里做一个「手机控制 ESP8266 开灯」的项目,演示时很风光,但一到带去教室、比赛现场或者放假回家,App 就连不上了——因为大多数教程用的是局域网直连(Socket、TCP 或者 App 直接访问 ESP8266 起的 Web 服务),手机和 ESP8266 必须在同一个 WiFi 里。这篇文章给出一个在国内网络环境下稳定可用的方案:ESP8266 通过 MQTT 接入中国移动 OneNET 平台,App Inventor 通过 OneNET 的 REST 接口下发命令、查询状态,手机在 4G/5G 流量下照样能控。
整体架构与一个重要提醒
手机 App(App Inventor)
│ HTTPS(REST 接口)
▼
中国移动 OneNET 云平台
▲ MQTT(1883 端口)
│
ESP8266 + 继电器/LED
先说一个很多人踩过的坑:不建议让 App 也用 MQTT 直接连 OneNET。OneNET 的 MQTT 接入里,一个设备同一时间只允许一个 MQTT 连接(第二个连上来会把第一个踢掉),而且设备之间不能互相直接发消息——下行命令走的是平台接口。所以网上一些旧教程「App 注册成另一个设备、直接订阅对方主题」的写法,在现在的 OneNET 上跑不通,或者两个端互相踢线。正确的分工是:
- ESP8266:作为设备用 MQTT 接入,负责上报状态、接收下行命令(这是 MQTT 的强项,低功耗、断线重连都好处理);
- App:用 Web 组件调 OneNET 的 REST 接口下发命令、用计时器轮询设备状态。对手机来说,隔几秒查一次数据完全够用。
另外一个坑:网上老文章里写的 183.230.40.39:6002、183.230.40.33:6002 这些地址是 OneNET 旧版多协议接入的,新注册的账号已经用不了了。新版 MQTT 服务器是 mqtts.heclouds.com,端口 1883(不加密)/ 8883(TLS)。
准备工作:OneNET 侧的配置
- 注册中国移动 OneNET 账号(open.iot.10086.cn),完成实名认证。
- 创建产品:接入协议选 MQTT,联网方式选 WiFi,数据协议用默认的 OneJSON(物模型)。
- 在产品里添加物模型功能点:比如建一个布尔型的功能点,标识名
led,读写方向「读写」(读写才能被命令下发)。 - 创建设备,记下三个东西(三元组):产品 ID(product_id)、设备名称(device_name)、设备密钥(device key,access_key)。
- 生成 token:OneNET 新版的 MQTT 密码和 REST 接口鉴权都用 token,格式是
version=2018-10-31&res=products/xxxx/devices/yyyy&et=有效期时间戳&method=md5&sign=签名。签名自己算比较麻烦,用官方提供的 token 生成工具(产品文档里有网页版/下载版),填入 res、key、method 选 md5,et(过期时间)教学项目直接给个几年的时间戳,生成的 token 复制保存好。注意 ESP8266 和 App 各自需要一个 token(res 分别指向自己用的那个设备或整个产品,工具里按提示填)。
ESP8266 端:Arduino 代码要点
环境:Arduino IDE + ESP8266 开发板支持包 + PubSubClient 库。核心逻辑:连 WiFi → 连 MQTT(ClientID 用设备名,用户名用产品 ID,密码用上面生成的 token)→ 订阅属性设置主题 → 收到命令就开关灯 → 每隔一段时间上报状态。
#include <ESP8266WiFi.h>
#include <PubSubClient.h>
WiFiClient net;
PubSubClient mqtt(net);
const char* PRODUCT_ID = "你的产品ID";
const char* DEVICE_NAME = "你的设备名";
const char* TOKEN = "你生成的token"; // 长字符串
const char* MQTT_SERVER = "mqtts.heclouds.com";
const int MQTT_PORT = 1883;
// 物模型主题
String topicSet = "$sys/" + String(PRODUCT_ID) + "/" + DEVICE_NAME + "/thing/property/set";
String topicPost = "$sys/" + String(PRODUCT_ID) + "/" + DEVICE_NAME + "/thing/property/post";
bool ledOn = false;
void callback(char* topic, byte* payload, unsigned int len) {
// 下行的 OneJSON 大致是 {"id":"1","params":{"led":true}}
String msg = "";
for (unsigned int i = 0; i < len; i++) msg += (char)payload[i];
if (msg.indexOf("\"led\":true") >= 0) { ledOn = true; digitalWrite(2, HIGH); }
if (msg.indexOf("\"led\":false") >= 0) { ledOn = false; digitalWrite(2, LOW); }
report(); // 立刻回一次状态
}
void report() {
// OneJSON 上报格式
String body = "{\"id\":\"1\",\"version\":\"1.0\",\"params\":{\"led\":";
body += ledOn ? "true" : "false";
body += "}}";
mqtt.publish(topicPost.c_str(), body.c_str());
}
void setup() {
pinMode(2, OUTPUT);
WiFi.begin("你的WiFi名", "你的WiFi密码");
while (WiFi.status() != WL_CONNECTED) delay(500);
mqtt.setServer(MQTT_SERVER, MQTT_PORT);
mqtt.setCallback(callback);
}
void loop() {
if (!mqtt.connected()) reconnect(); // 重连函数里做 mqtt.connect(设备名, 产品ID, token)
mqtt.loop();
static unsigned long last = 0;
if (millis() - last > 30000) { // 每30秒上报一次
last = millis();
if (mqtt.connected()) report();
}
}
连上后,先到 OneNET 控制台的设备调试 / 命令下发页面手动发一个 {"led":true},看板上灯有没有亮、属性值有没有变化。平台侧验证通过再写 App,不然出了问题分不清是设备端还是 App 端。
App Inventor 端
组件清单:文本输入框、按钮(开灯、关灯)、标签(显示状态)、Web 两个(Web_下发、Web_查询,分开用避免消息混在一起)、计时器(定时查询)、微数据库(可选,记住 token)、对话框。这些组件都是内置的,不用装扩展。
整体积木逻辑:
global 产品ID = "你的产品ID"
global 设备名 = "你的设备名"
global 平台Token = "version=2018-10-31&res=..."
when 按钮_开灯.Click() {
下发属性(true)
}
when 按钮_关灯.Click() {
下发属性(false)
}
procedure 下发属性(开关值) {
Web_下发.Url = "https://iot-api.heclouds.com/thingmodel/set-device-property"
Web_下发.RequestHeaders = [["token", 平台Token]]
Web_下发.PostText(join("{\"product_id\":\"", 产品ID, "\",\"device_name\":\"", 设备名, "\",\"params\":{\"led\":", 开关值, "}}"))
}
when Web_下发.GotText(url, responseCode, responseType, responseContent) {
if responseCode = 200 and textContains(responseContent, "\"code\":0") {
对话框1.ShowAlert("命令已下发")
} else {
对话框1.ShowAlert(join("下发失败:", responseContent))
}
}
when 计时器_查询.Timer() {
Web_查询.Url = join("https://iot-api.heclouds.com/thingmodel/query-device-property?product_id=", 产品ID, "&device_name=", 设备名, "&identifier=led")
Web_查询.RequestHeaders = [["token", 平台Token]]
Web_查询.Get()
}
when Web_查询.GotText(url, responseCode, responseType, responseContent) {
if textContains(responseContent, "\"value\":true") {
标签_灯状态.Text = "灯:开"
} else if textContains(responseContent, "\"value\":false") {
标签_灯状态.Text = "灯:关"
}
}
两点说明:
- 计时器的 TimerInterval(计时间隔)建议设 3000~5000 毫秒,别太快,一是费流量,二是查询太频繁没有意义。
- 判断灯状态上面用了简单的文本包含判断,方便快速跑通;如果你要做多个属性的状态面板,建议改用 Web 组件的解码JSON文本把返回的 JSON 解析成字典再逐个取值,更严谨。Web 组件的完整属性和方法见组件中文文档,对着积木面板核对一遍再连。
常见连不上 / 不生效排查
按出现频率从高到低:
- ESP8266 连 MQTT 一直失败:九成是 token 的问题。检查 res 是否填对(是
products/产品ID/devices/设备名这种格式)、et 时间戳是否已过期、key 是不是复制成了别的产品的。token 错了 MQTT 会直接断开且提示不明显,多试几个 method(md5/sha1/sha256)和工具选项。 - 宿舍/公司 WiFi 下 ESP 连不上,手机热点下正常:很多校园网和办公网封了 1883 这类非网页端口。这不是你代码的问题,换个网络测试,或者改走 8883 的 TLS(PubSubClient 需要换用 WiFiClientSecure 并设置 setInsecure)。
- 命令下发返回成功,ESP 没反应:检查三件事——物模型功能点是不是建了、标识名是不是严格叫
led(大小写一致)、功能点方向是不是「读写」(只读的属性平台不会下发)。另外确认 ESP 确实订阅了$sys/.../thing/property/set这个主题,拼错一个字符都收不到。 - App 端返回 401 / 鉴权失败:REST 用的 token 和 MQTT 的 token 不一定要同一个,res 的范围不同;用生成工具重新生成一个指向你设备的 token 给 App 用。
- App 切到后台就收不到状态了:这是国产手机的后台管控,不是 App 的 bug。小米/红米:安全中心 → 应用管理 → 给你的 App 开自启动、省电策略改为「无限制」;华为/荣耀:设置 → 电池 → 启动管理里关掉「自动管理」、允许后台活动;OPPO/vivo 类似,在电池和权限管理里放行。测试时最好保持 App 在前台。
- 被同产品下另一个连接踢线:如果你之前调试时在电脑上开着 MQTT 调试工具连了同一个设备,ESP 会反复掉线。同一设备同时只能有一个 MQTT 连接,调试工具记得断开。
小结
这个方案的本质是「设备端走 MQTT,手机端走 REST,云端做中转」,绕开了局域网的限制,也符合 OneNET 目前的接入规范。搭好一次之后,扩展很方便:加个 DHT11 温湿度,ESP 端在 report 里多传一个属性,App 端查询里多解析一个标识名,就是一个可以带去比赛展示的远程环境监控项目了。
最后提醒一句安全:token 直接写在 App 里,APK 发给别人就能被提取,教学和比赛项目问题不大,但如果要做真正部署的产品,中间应该加一层自己的后端服务做鉴权,别把平台密钥放进手机 App。
扫码添加客服咨询