真实运行截图一、功能都写完了为什么还要写测试我这个物联网设备接入平台Spring Boot 3.5 EMQX MySQL从设备注册、MQTT 接入、消息入库到密钥轮换功能主线已经跑通了。但每次面试话题走到质量保障我都心虚——功能是我手点出来的谁保证我下次改一行代码不会把注册接口改挂测试在项目里的位置是这样的接入层、数据层、安全层的功能代码是存货测试是保险。每次给设备加新字段、给消息处理加新分支跑一遍测试就知道有没有把老功能弄坏。这在物联网领域尤其重要——设备的认证/ACL 逻辑改坏了不是页面白屏而是陌生设备能连进你的 Broker。先交代结论项目现在有11 个测试类、37 个测试用例mvn test全绿见第一张截图整体行覆盖率 76%。下面讲这 37 个用例怎么组织的。二、两类测试的分工谁该连数据库谁不该我的测试分两类对应测试金字塔的两层类型代表依赖测什么纯单元测试TelemetryMessageHandlerTest不起 SpringRepository 全部 Mock消息处理的业务逻辑分支Web 层测试DeviceControllerTest、AdminTokenInterceptorTest等SpringBootTest H2 内存库HTTP 接口从过滤器到数据库的整条链路分工原则一句话逻辑分支多的用纯单元测试跑得快跨层协作的用 MockMvc 测真实行为。消息处理类里全是 if/else 分支未知设备、productKey 不匹配、非法 JSON……起一次 Spring 上下文要好几秒纯单元测试毫秒级跑完而注册接口到底返回 201 还是 409这种问题Mock 不出来必须让请求真穿过拦截器和 JPA。三、消息链路纯单元测试Mockito ArgumentCaptor被测的TelemetryMessageHandler是 MQTT 消息的入口来源src\main\java\com\iothub\mqtt\TelemetryMessageHandler.java核心逻辑解析主题up/{productKey}/{deviceId}校验设备存在且 productKey 匹配再按up/st分流。TestvoidtelemetryMarksDeviceOnlineAndSavesDataPoint(){when(deviceRepository.findById(1L)).thenReturn(Optional.of(device));handler.handle(up/th-sensor/1,{\temp\:25.5,\humi\:60});assertThat(device.getStatus()).isEqualTo(online);verify(deviceRepository).save(device);// ArgumentCaptor 抓住传给 Mock 的对象逐字段断言ArgumentCaptorDataPointcaptorArgumentCaptor.forClass(DataPoint.class);verify(dataPointRepository).save(captor.capture());assertThat(captor.getValue().getDeviceId()).isEqualTo(1L);assertThat(captor.getValue().getProductKey()).isEqualTo(th-sensor);assertThat(captor.getValue().getPayload()).contains(25.5);}来源src\test\java\com\iothub\mqtt\TelemetryMessageHandlerTest.java类上用ExtendWith(MockitoExtension.class)不起 Spring 容器这个类一共 5 个用例专门冲着异常分支去的未知设备直接丢弃、productKey 不匹配丢弃、非法 JSON 丢弃、状态消息只改设备状态不存数据点。为什么这么设计因为消息链路的正常路径只有一条出事的永远在异常路径——伪造的 productKey、断电设备发来的脏数据都得在这里拦住。测试里把每个丢弃分支都钉死以后谁改这段代码漏了校验测试立刻红。四、接口层测试MockMvc 从拦截器一路测到数据库注册接口是平台最核心的入口DeviceControllerTest三个用例把三种结局都锁死了TestvoidregisterSuccessReturnsSecretOnce()throwsException{// ... post /api/devices 断言 201 code0 secret/clientId 非空 ...// 从响应里抠出明文密钥再验证库里存的确实是哈希而不是明文DevicesaveddeviceRepository.findAll().stream().filter(d-test-温湿度-001.equals(d.getDeviceName())).findFirst().orElseThrow();assertThat(saved.getSecretHash()).isNotEqualTo(secret).isEqualTo(DeviceService.sha256(secret));}来源src\test\java\com\iothub\device\DeviceControllerTest.java这个用例我最得意的地方不是测了 201而是最后三行从响应里拿到明文密钥再断言数据库里存的不是明文、且等于 SHA-256(明文)。接口测试的价值就在这——它能穿透到数据库验证副作用这是 Postman 手点给不了的。另一个套路是写操作测权限AdminTokenInterceptorTest用 5 个用例验证管理令牌无令牌 401、错令牌 401、对令牌放行、GET 公开、EMQX 回调豁免。注意类上有MockBean private MqttConnection mqttConnection——起 Spring 上下文但不让它真连 Broker这是物联网项目 Web 测试的关键技巧测接口不测网络。五、测试抓出来的两个真 Bug测试不是摆设这两个真 Bug 就是它抓的Bug 1浏览器要个 favicon.ico日志里炸出一条 500。ErrorResponseTest里前两个用例是专门的回归测试——之前没单独处理NoResourceFoundException任何浏览器访问/favicon.ico都会被全局异常兜底捕获返回 500还刷一条 ERROR 堆栈。修完之后测试钉死现在必须返回 404 code404。Bug 2MockMvc 默认按 ISO-8859-1 解码响应中文断言全乱码。测静态看板页时getContentAsString()拿到的中文全是问号断言设备实时监控看板永远失败。解法是显式传编码getContentAsString(StandardCharsets.UTF_8)ErrorResponseTest源码里有注释标注。这种坑不写测试你根本遇不到因为浏览器会自己猜编码。六、跑测试 JaCoCo拿真实数字别拍脑袋跑测试和覆盖率不需要改 pom.xml命令行直接拼插件目标mvn org.jacoco:jacoco-maven-plugin:0.8.12:prepare-agenttestorg.jacoco:jacoco-maven-plugin:0.8.12:report今天的真实结果见前两张截图Tests run: 37, Failures: 0, Errors: 0, Skipped: 0BUILD SUCCESS。覆盖率报告在target\site\jacoco\index.html真实数字包行覆盖说明com.iothub.device96%注册/生命周期MockMvc 覆盖最全com.iothub.common94%拦截器/异常处理回归测试钉死com.iothub.data89%查询接口与保留任务com.iothub.mqtt75%认证/ACL 很高MqttConnection 重连逻辑低com.iothub.ws13%WebSocket 推送循环基本没测整体76%指令覆盖 79%、分支覆盖 71%说句实话ws 包那 13% 我不打算现在补。WebSocket 推送是定时循环会话广播Mock 它的成本远超收益我的取舍是用真实浏览器开两个标签页人工验收过M4 里程碑那次。覆盖率是体检报告不是 KPI——它最大的用处是告诉你风险在哪而不是逼你凑 100%。面试里能讲清哪块没测、为什么暂不补比一句覆盖率 90%更加分。面试考点小结测试金字塔分工逻辑分支 → Mockito 纯单元测试跨层协作 →SpringBootTest MockMvc H2 内存库MockBean的用途隔离外部依赖MQTT Broker测业务不测网络ArgumentCaptor断言传给依赖的对象长什么样而不只是调用过没有回归测试Bug 修完必须留一个用例钉死防止复发覆盖率工具JaCoCo 不改 pom 也能用 CLI 挂上覆盖率看分布不看总分。写在最后我是软件工程在读正在从零搭一个物联网设备接入平台Spring Boot EMQX MySQL这篇是质量保障这条支线的第一篇。写这篇之前我以为测试是任务写完发现那两个真 Bug 已经回本了。下一篇计划写 EMQX 共享订阅或 Kafka 解耦。你项目里的测试覆盖率是多少评论区聊一句比点赞更让我高兴。本文所有数据均为本机实测2026-10-10mvn test37 个用例全绿、JaCoCo 覆盖率来自target\site\jacoco\真实报告代码均摘自项目D:\dev\iot-device-platform真实源码并标注来源文件截图为真实测试输出与报告画面。