速查在线工具箱照着接口 JSON 生成实体类，类型为什么总是错的？
数组看首元素、整数默认 int、null 不带类型，三个默认值就是三处坑。
直接答案
数组类型按第一个元素推断，遇到空数组或首元素是 null 时，生成器无从判断，只能给最宽泛的类型。
Java 里整数默认生成 int，字段一旦超过二十一亿就会溢出；金额类字段应当改成 BigDecimal 而不是 double。
字段名与语言关键字冲突、JSON 键带下划线或短横时，需要重命名并补上序列化注解，否则反序列化会拿不到值。
接口返回一段 JSON，粘进生成器一键出实体类，编译通过、运行却报类型转换异常，问题往往出在样本没覆盖到的形状上。
生成器不是编译器，它只会照着样本猜，猜不到的地方需要人来定。
1三类必错场景
样本里没出现过的形态，生成结果一定是猜的。
| 场景 | 生成结果 | 正确做法 |
|---|---|---|
| 空数组 | 最宽泛类型或对象数组 | 按业务改成具体元素类型 |
| 首元素为 null | 推断失败或给通用类型 | 用真实数据样本重新生成 |
| 整数超二十一亿 | int 越界 | 改成 long 或 BigInteger |
| 金额小数 | double 精度丢失 | 改成 BigDecimal 并指定精度 |
生成完先扫一遍所有 List 和金额字段，这两处是返工率最高的地方。
2命名与注解别漏
键名不合语言习惯时，代码能编译但反序列化拿不到值。
- 下划线键名
- user_name 对应不了 userName
- 短横线键名
- user-name 直接不是合法标识符
- 语言关键字
- class、type、def 撞名
- Go 结构体
- 字段首字母大写才可导出
用 Gson 时对应的是 SerializedName，两个库的注解别混用，否则注释不生效还不报错。
3生成之后还要做什么
生成器负责省掉体力活，边界条件仍要人工过一遍。
- 补齐可选字段
- 样本里缺少的字段未必不会来
- 拆嵌套类命名
- 自动生成的类名可能重名
- 加日期格式
- 时间戳与字符串两种形态
- 留一份原始 JSON
- 后续对比字段增减
接口字段一旦变动，实体类要跟着改；把生成时的 JSON 存进测试用例，比事后翻日志省事。
顺着这个问题往下用
全部工具总览 →相关疑问
为什么数组被生成成了对象数组？
因为样本里那个数组是空的，生成器没有元素可以参考，只能退化成最宽泛的类型。换成带真实元素的样本重新生成即可。
Java 里金额为什么不能用 double？
double 是二进制浮点，无法精确表示 0.1 这类十进制小数，累加后会出现 0.30000000000000004 这样的尾差，金额要用 BigDecimal 并指定精度。
嵌套对象会被拆成独立类吗？
会。生成器通常把嵌套对象拆成单独的类，字段引用它；如果多个层级出现同名字段，还会自动加后缀区分，建议按业务语义重命名。
生成的代码能直接上线吗？
能当骨架，但要补三件事：核对集合元素类型、确认金额与时间字段的精度和格式、补上接口文档里存在但样本中没有的可选字段。
继续看：相关问题与资料
全部问题解答 →
内容标识：本页内容由人工智能辅助生成，并经人工核对与编辑。详见 人工智能生成内容标识说明。
内容说明：本页针对具体使用问题作答，方法步骤与数值由本站自行整理与复算，事实性内容以对应官方规范与文档为准。内容最后核对日期：2026-10-22。若发现错误，欢迎通过页脚反馈入口告知。
内容说明：本页针对具体使用问题作答，方法步骤与数值由本站自行整理与复算，事实性内容以对应官方规范与文档为准。内容最后核对日期：2026-10-22。若发现错误，欢迎通过页脚反馈入口告知。