Lombok 真有问题吗？

[Lombok 真有问题吗？------深入解析 get/set 首字母大小写陷阱](#Lombok 真有问题吗？——深入解析 get/set 首字母大小写陷阱)
- [一、Lombok 做了什么？](#一、Lombok 做了什么？)
- [二、JavaBean 命名规则才是关键](#二、JavaBean 命名规则才是关键)
- 三、问题一：字段首字母大写
- - [❌ 错误写法](#❌ 错误写法)
- [四、问题二：boolean + is 前缀](#四、问题二：boolean + is 前缀)
- - [❌ 常见写法](#❌ 常见写法)
- 五、问题三：全大写字段
- [六、为什么在 Spring 体系下更明显？](#六、为什么在 Spring 体系下更明显？)
- [七、行业最佳实践（避免 99% 的坑）](#七、行业最佳实践（避免 99% 的坑）)
- - [✅ 1. 字段永远小驼峰](#✅ 1. 字段永远小驼峰)
  - [✅ 2. boolean 不要以 is 开头](#✅ 2. boolean 不要以 is 开头)
  - [✅ 3. 数据库字段用下划线，Java 用驼峰](#✅ 3. 数据库字段用下划线，Java 用驼峰)
- [八、底层本质：属性名 ≠ 字段名](#八、底层本质：属性名 ≠ 字段名)
- 九、结论

Lombok 真有问题吗？------深入解析 get/set 首字母大小写陷阱

在日常开发中，很多人会说：

"Lombok 有时候会出问题。"

但真正深入排查后你会发现，大多数所谓的 "Lombok bug"，本质上都和 字段命名 + JavaBean 规范 + 反射解析规则有关，而不是 Lombok 本身出错。

本文将系统讲清楚：
为什么字段首字母大小写会影响 Spring、Jackson、MyBatis 的行为。

一、Lombok 做了什么？

Lombok（Project Lombok）的核心作用是：

根据字段自动生成 getter / setter
遵循 JavaBean 命名规范

例如：

java 复制代码

@Getter
@Setter
public class User {
    private String name;
}

Lombok 生成：

java 复制代码

public String getName();
public void setName(String name);

一切正常。

二、JavaBean 命名规则才是关键

很多人忽略一个事实：

Java 里的"属性名"并不等于"字段名"。

属性名是由 getter 方法推导出来的。

JavaBean 规范规定：

getName() → 属性名 name
getUserName() → 属性名 userName

规则核心是：

去掉 get，首字母小写（特殊情况除外）

这就埋下了问题的根源。

三、问题一：字段首字母大写

❌ 错误写法

java 复制代码

private String Name;

Lombok 会生成：

java 复制代码

getName()

根据 JavaBean 规则：

属性名是 name
但字段名是 Name

⚠ 字段名 ≠ 属性名

当框架通过反射绑定数据时，就可能出现：

JSON 反序列化失败
MyBatis 映射不到字段
Spring 参数绑定异常

四、问题二：boolean + is 前缀

❌ 常见写法

java 复制代码

private boolean isDeleted;

Lombok 生成：

java 复制代码

isDeleted()
setDeleted()

注意：

getter 是 isDeleted()
setter 是 setDeleted()

属性名被推导为：

复制代码

deleted

而不是：

复制代码

isDeleted

这会导致：

JSON 字段错位
数据库字段不匹配

五、问题三：全大写字段

java 复制代码

private String URL;

生成：

java 复制代码

getURL()

根据 JavaBean 规则：

如果前两个字母大写，不会强制转小写

于是可能出现：

复制代码

URL
uRL

不同框架处理细节不同，结果就炸。

六、为什么在 Spring 体系下更明显？

以下框架都依赖 JavaBean 规范进行反射解析：

Spring Framework
Jackson
MyBatis

它们的底层逻辑通常是：

复制代码

根据 getter 推导属性名
而不是直接用字段名

因此：

字段命名不规范
getter 推导出的属性名变化
框架映射就出现问题

于是你感觉：

"Lombok 出问题了"

实际上：

是字段命名破坏了 JavaBean 规范的一致性。

七、行业最佳实践（避免 99% 的坑）

✅ 1. 字段永远小驼峰

java 复制代码

private String userName;
private String url;
private boolean deleted;

不要：

java 复制代码

private String UserName;
private String URL;

✅ 2. boolean 不要以 is 开头

✅ 3. 数据库字段用下划线，Java 用驼峰

数据库：

复制代码

user_name

Java：

java 复制代码

private String userName;

通过 MyBatis 或 Spring 的映射规则转换。

八、底层本质：属性名 ≠ 字段名

真实链路是：

复制代码

字段 → Lombok 生成 getter
       ↓
JavaBean 规范推导属性名
       ↓
Spring / Jackson / MyBatis 反射绑定
       ↓
JSON / 参数 / 数据库映射

任何一步命名不规范，都会导致整条链路失效。

九、结论

✔ Lombok 没有问题

✔ JavaBean 规范是核心

✔ 反射框架依赖 getter 推导属性名

✔ 字段命名不规范才是根源

一句话总结：

实体类字段永远小驼峰、首字母小写、boolean 不加 is 前缀。

掌握这个规则，你在 Spring 体系里的数据绑定问题会减少 90% 以上。