Files
starRiverProperty/docs/reviews/alibaba-audit-2026-04-24/03-maven-cloudwalk-device-sdk.md
T
2026-04-24 23:49:37 +08:00

1.2 KiB
Raw Blame History

03 maven-cloudwalk-device-sdk — 阿里巴巴规范走查(整理版)

范围maven-cloudwalk-device-sdk/**/*.java(排除 target/),约 162 个文件。

主要发现

类别 说明
序列化 大量 implements Serializable 的 DTO/Param 未声明 serialVersionUID(约数十个文件);内部静态类序列化缺独立 UID。
命名 NotifyUploadPanoramamResultPanorama)、FaceRegistionParamRegistration)等拼写疑点;内部类名 deviceDatahelmetsData 等小写开头不符合类型 UpperCamelCase。
格式 部分文件 package 与类型声明间大段空行;若仍残留 /* N */ 行号注释,应继续跑 scripts/strip_jdcore_java_noise.py
启发式 00-heuristic-scan.md 一致:DeviceV2CommonBaseDTO 等存在行尾空白;未见 System.out、空 catch。

建议优先级

  1. 为对外 DTO 统一 serialVersionUID 策略(或评估 Protobuf/JSON 单一序列化路径)。
  2. 修正对外可见的拼写错误类名时评估协议兼容(@JSONField 别名等)。
  3. IDE 格式化 + 去除反编译行号噪声。