2995840376
|
4d8d38909d
|
fix(I): HTTP 语义类异常返回真实 4xx 状态码, 不再兜底成 500
问题：GlobalExceptionHandler 只对业务异常/参数校验做了分类，其余异常一律被兜底的
Exception handler 处理成 500「系统繁忙」。例如以 application/octet-stream 发送
JSON 请求体本应返回 415 Unsupported Media Type，却得到 500，误导调用方与排障。
改动（iot-common，四个服务共用）：
- ResultCode 新增：UNSUPPORTED_MEDIA_TYPE(415) / NOT_ACCEPTABLE(406) / PAYLOAD_TOO_LARGE(413)
- GlobalExceptionHandler 新增 HTTP 语义类异常处理：
HttpMediaTypeNotSupportedException -> 415
HttpMediaTypeNotAcceptableException -> 406
HttpRequestMethodNotSupportedException-> 405
MissingServletRequestParameterException / MethodArgumentTypeMismatchException
/ HttpMessageNotReadableException -> 400
MaxUploadSizeExceededException -> 413
- 响应约定：真实 HTTP 状态码 + body.code 与状态码保持一致（沿用 JwtAuthenticationEntryPoint 的
401 约定）；业务/参数异常维持 HTTP 200 + body.code 的历史约定，前端无需改动
- 这类异常属客户端错误，日志级别由 error 降为 warn，避免污染错误日志
- 新增单测 iot-common/src/test/java/com/iot/common/exception/GlobalExceptionHandlerHttpStatusTest.java
（2 个用例全部通过）
生产验证：
错误 Content-Type -> HTTP 415 body.code=415
错误请求方法 -> HTTP 405
参数类型不匹配 -> HTTP 400
请求体 JSON 非法 -> HTTP 400
正常列表/物模型 -> HTTP 200
前端 axios 拦截器对非 401/403/500 的 4xx 走 data?.message 分支，提示更准确，无回归。
|
2026-10-27 19:31:56 +08:00 |
|
2995840376
|
a932633c50
|
refactor(A): 产品/物模型/设备三层架构重构 - 地基批次
新增:
- iot-common/PlatformType: 平台维度单一真相源(枚举)
统一 tuya/matter/local/xiaomi/huawei/dueros/alexa/google_home,
提供 legacy 别名归一(miot|mi -> xiaomi)与已知性判定
- backend/sql/V22__product_device_arch_refactor.sql: 幂等迁移(153行)
A. platform_type 平台字典表 + 种子数据(后台可维护)
B. product 加 protocol 列; platform_product_id 空串清洗为 NULL;
清洗 model/manufacturer 被涂鸦 productId 污染的历史脏数据;
加 (platform, platform_product_id, deleted) 唯一约束
C. product_property 加 grp/is_primary/enum_label + (product_id,code) 唯一约束
D. product_event/product_action 加 (product_id,code) 唯一约束;
product_action 加 completion_mode
E. device 加 product_id 索引(OTA 物化目标设备此前全表扫); platform 归一
改造:
- DeviceAdapter 新增 platform() 显式声明平台
- DeviceAdapterManager 改为按 platform() 精确匹配,
移除'类名是否包含平台字符串'的脆弱约定(类名与平台码不同名会静默降级)
- DevicePlatform 委托 PlatformType, 消除第四套平台取值域
验证: mvn -pl iot-common,iot-device -am compile 通过
|
2026-10-27 12:08:44 +08:00 |
|
2995840376
|
0ce191c448
|
chore: 初始化 iotsaas 版本库基线
纳入范围:
- backend/ Spring Boot 多模块后端(iot-common/device/rule/data/alarm/auth)
- frontend/admin/ Vue3 + Element Plus 管理后台
- Android/ 涂鸦原生 APP (com.xhai.iot)
- backend/sql/ Flyway 风格迁移脚本(V2~V21)
- docs/ 对接文档与设计文档
排除范围:
- 构建产物: node_modules/ target/ build/ dist/ .gradle/
- 签名密钥: *.jks *.keystore (严禁入库)
- 本机配置: Android/local.properties
- 运行日志: logs/ *.log
- AI 协作本地数据 .codebuddy/ 与第三方 demo tuya-demo/
.gitattributes 统一以 LF 存储, Windows 批处理保留 CRLF
|
2026-10-27 12:00:41 +08:00 |
|