前端传递 Boolean 值时的坑（isXxx 为 false 问题）

为什么我的 Spring Boot 接收不到前端传的 Boolean 值？—— 彻底解决 isShare 为 false 的玄学问题

1. 运行环境

• 后端核心栈：Spring Boot 3.x, JDK 17, Lombok, Jackson (Spring 默认 JSON 解析器)
• 前端环境：Uni-app (Vue3 + Vite), Axios / uni.request
• 交互协议：RESTful API (Content-Type: application/json)

---

2. 问题详情 (The Issue)

在开发课程记录系统（class_times_record）时，需要根据 isShare 字段判断是查询“个人私有记录”还是“他人分享记录”。

后端 DTO 定义：

@Data
public class QueryCourseRecordDTO {
    private boolean isShare; // 注意：字段以 is 开头
    private Long id;
    // ... 其他字段
}

前端请求数据：

{
    "id": "2",
    "isShare": true,
    "currentPage": 1,
    "pageSize": 1
}

现象：
后端 Controller 接收到的 dto.isShare() 永远是 false，导致查询 SQL 强制带上了 user_id 过滤条件，无法查询到分享数据。

---

3. 深度原理分析 (The Why)

这个问题并非代码逻辑错误，而是 Lombok 命名规范 与 Jackson 反序列化机制 之间的“暗战”。

A. Lombok 的 Setter 生成规则

对于 boolean 类型的字段，如果变量名以 is 开头（如 isShare），Lombok 生成的方法不是 setIsShare，而是：

• Getter: isShare()
• Setter: setShare(boolean share) <-- 重点：它把 is 自动去掉了！

B. Jackson 的自省机制

Spring 默认使用 Jackson 库将 JSON 字符串转为 Java 对象。Jackson 在处理 JSON 中的 "isShare": true 时：

1. 它会尝试寻找 setIsShare 方法，失败。
2. 它会尝试寻找字段 isShare，但在开启了标准 JavaBean 扫描时，它更倾向于通过 Setter 匹配。
3. 由于找不到匹配的入口，Jackson 选择忽略该字段，导致 isShare 保持了基本类型的默认值 false。

---

4. 解决办法 (The Solution)

方案一：遵循 Java 规范（最推荐 ⭐⭐⭐⭐⭐）

操作： 将变量名改为非 is 开头，并使用包装类 Boolean。

@Data
public class QueryCourseRecordDTO {
    private Boolean share; // 推荐命名：share
}

• 理由：Lombok 会生成 setShare，Jackson 匹配 "share": true，完美闭环。使用 Boolean 包装类可以区分“用户传了 false”和“用户没传（null）”。

方案二：使用 @JsonProperty 强行指定

操作： 如果你必须保留 isShare 这个变量名，使用注解显式映射。

@Data
public class QueryCourseRecordDTO {
    @JsonProperty("isShare") 
    private Boolean isShare;
}

• 理由：直接告诉 Jackson：“不管 Setter 叫什么，只要看到 JSON 里的 isShare，就塞给我”。

方案三：前端适配后端“去 is”后的名称

操作： 前端 JSON 直接传 share 而不是 isShare。

{ "share": true }

---

5. 总结与建议

在 Spring 生态中，“约定大于配置”。

1. 避开 is 前缀：在定义 POJO/DTO 的布尔字段时，尽量直接用 status、deleted、share，而不是 isStatus、isDeleted。
2. 首选包装类：使用 Boolean 而非 boolean。在复杂的业务逻辑中，null 往往比默认的 false 更有表达力，能避免很多隐蔽的 Bug。
3. 日志先行：遇到这种参数接不到的情况，第一时间在 Controller 打印 RequestBody 的原始字符串，确认是前端没发对，还是后端没接准。

---