JavaBeans规范要求getter/setter严格遵循命名约定，如boolean字段用isXxx()、多单词字段驼峰大写、URL字段用getURL()，禁止在其中添加业务逻辑或副作用，并注意Lombok兼容性与继承陷阱。
Java里getter和setter方法不是随便起名或加逻辑就能算“规范”的——IDE自动生成的只是语法合法，不等于符合JavaBeans规范、不影响序列化、不破坏Lombok兼容性，更不一定适合实际业务场景。
getter/setter必须严格遵循JavaBeans命名约定
这是反序列化（如Jackson、XML解析）、反射框架（Spring BeanUtils）、IDE自动识别字段绑定的前提。违反会导致PropertyNotFoundException或静默失败。
- 布尔类型字段推荐用
isXxx()而非getXxx()：比如private boolean enabled;→public boolean isEnabled()，public void setEnabled(boolean enabled) - 首字母小写的多单词字段，驼峰后首字母必须大写：比如
private String userName;→getUserName()，不是getusername()或getUserName()拼错成getUsernName() - 字段名为
URL时，标准写法是getURL()，不是getUrl()；但setUrl()会被部分工具误判，稳妥做法是统一用getURL()/setURL(URL url)
不要在getter/setter里写业务逻辑或副作用
看似“方便”，实则埋下严重隐患：Hibernate懒加载触发、Jackson序列化死循环、单元测试难Mock、Lombok@Data生成冲突。
- 禁止在
getCreateTime()里自动调用new Date()—— 这会让每次访问都返回新时间，且破坏不可变性假设 - 禁止在
setName(String name)里做trim()或校验并抛异常 —— setter应只赋值，校验应放在构造函数或专门的validate()方法中 - 避免getter中调用
Objects.requireNonNull()或懒初始化集合：这会让Jackson在序列化时意外触发NPE或改变对象状态
使用Lombok时注意与手动getter/setter共存的陷阱
Lombok的@Getter/@Setter不会覆盖已存在的同签名方法，但会跳过生成 —— 表面无报错，实则行为不一致。
立即学习“Java免费学习笔记（深入）”；
- 如果类里已有
getName()，再加@Getter，Lombok不会警告，但getName()逻辑不会被增强（比如你忘了同步加@NonNull校验） -
@Data默认包含@Getter/@Setter，但如果某个字段加了transient，Lombok仍会为它生成setter —— 可能导致反序列化时意外覆盖瞬态字段 - 继承关系中，父类用
@Getter，子类手动写getAge()，IDE可能提示“method hides another method”，但运行时JVM按重写规则调用，容易误判行为来源
需要定制行为时，优先用组合而非重写getter/setter
比如字段需加密存储、单位转换、缓存计算结果，硬改getter/setter会让职责混乱，且难以复用。
- 敏感字段如
password，用单独的encryptPassword(String raw)和matchesPassword(String input)，而不是在setPassword()里加密 - 时间字段如
createTime（数据库存秒级时间戳），暴露为LocalDateTime时，用getCreateTimeAsLocalDateTime()显式命名，不覆盖getCreateTime()（保持原始long语义） - 计算属性如
fullName，不声明字段，直接提供getFullName()，并加上@JsonIgnore（防JSON序列化）和@Transient（防JPA持久化）
public class User {
private Long id;
private String firstName;
private String lastName;
private int age;
// 计算属性，不对应数据库字段
public String getFullName() {
return firstName + " " + lastName;
}
// 显式转换方法，避免歧义
public LocalDateTime getBirthDateAsLocalDateTime() {
return Instant.ofEpochSecond(birthTimestamp).atZone(ZoneId.systemDefault()).toLocalDateTime();
}
}
真正麻烦的从来不是“怎么写”，而是“为什么不能那样写”——比如getURL()少一个U，可能让OpenAPI文档生成器彻底丢掉这个字段；setEnabled(true)里悄悄记录日志，会让批量更新性能骤降却难以排查。规范不是约束，是降低协作熵值的最小公约数。
