大家好，我是晚安code。

说到 Java 编程规范。很多同学第一反应是“条条框框，烦死了”。说起来，但阿里《Java 开发手册》里的规约几乎每一条都是拿线上故障换来的。这篇文章把手册里最容易让项目翻车的规约筛出来按命名、日期数值、集合、并发、数据层五类整理成一份避坑清单，每条都配反例和事故场景。说起来，建议先收藏，下次 code review 前翻一遍。

一、命名：别让名字埋雷

命名不只是好不好看的问题——名字起错，框架解析都可能翻车。这套 Java 命名规范里有三条最致命：

1️⃣ Boolean 字段加 is 前缀

PITFALL: 反例是 private Boolean isDeleted;不过，，getter 自动生成 isDeleted序列化时框架会误以为字段叫 deleted导致该字段直接丢失。SOLUTION: 正确写法是 private Boolean deleted;老实说，

2️⃣ 拼音和英文混排

PITFALL: 反例如 DaZhePromotiongetPingfenByName。怎么说呢，读代码跟猜谜一样。怎么说呢，SOLUTION: 手册要求：命名用完整英文单词组合。纯拼音也不行，

3️⃣ 魔法值直接写死

PITFALL: 有次 debug 一个缓存查不到的 bug 查了一下午，后来发现是两个 key 一个带了下划线一个没带——开发者 A 写 "Id#taobao_" + tradeId;,开发者 B 复制时少了个下划线。SOLUTION:

// 反例
String key = "Id#taobao_" + tradeId;// 正确
public static final String CACHE_KEY_PREFIX = "Id#taobao_";String key = CACHE_KEY_PREFIX + tradeId;

至于使用者痛点。

"我经常在项目中发现前端拿不到某些字段，却不知道是因为命名冲突导致 JSON 丢失"。

二、日期与数值：翻车率最高的两类

#1 YYYY 与 yyyy 的区别

PITFALL: 小写 yyyy 是“当天所在的年”，大写 YYYY 是“当天所在周属于的年份”。如果用 YYYY-MM-dd,线上日志和报表全线错位。SOLUTION:

new SimpleDateFormat // 正确
new SimpleDateFormat // 反例：跨年必翻车

#2 SimpleDateFormat 线程不安全

PITFALL: 定义成 static 并共享，多线程下偶发解析错乱。SOLUTION:

• Migrate to JDK8+ DateTimeFormatter .
• If you must use SimpleDateFormat,wrap it in ThreadLocal.

#3 浮点数比较 && BigDecimal 使用错误

"为什么我的浮点运算结果总是不准确？"

• PITFALL ①：`==` 比较浮点数会产生误差。例如 `if ` 对于 `.0F - .9F` 与 `.9F - .8F` 返回 false。
• SOLUTION ①：`if <1e-6f) { … }` 或使用 BigDecimal。

• PITFALL ②：`BigDecimal.equals` 会比较精度；`compareTo` 忽略精度才符合业务需求。
• SOLUTION ②：`new BigDecimal` 用字符串构造；若从 double 入参，请使用 `valueOf`。按理说，

使用者痛点的观点是。

"在报表模块出现日期偏移或浮点计算错误，我花了好几天排查根源却没找到"。怎么说呢，

三、集合操作：一半事故出在这

• "为什么我在遍历 List 时删元素会导致 ConcurrentModificationException？"

#1 foreach 删除元素导致异常或跳过元素

PITFALL : for-each 底层是 Iterator，边遍历边调用 `list.remove` 会抛 ConcurrentModificationException 或跳过元素。SOLUTION :

• it = list.iterator;while ) { if )) it.remove;} 或者 JDK8 的 `removeIf`: java list.removeIf);

#2 Integer == 比较陷阱

• PITFALL : - 到 - 范围内有 IntegerCache 重用对象，这个区间用 == 碰巧没问题； 超出后每次都是新对象，SOLUTION : - 总是使用 equals 或 Objects.equals。java Integer a = /*some value*/;Integer b = /*some value*/;System.out.println);// true/false as expected
  至于**注**。上述代码已放置于 `

  ` 标签内，以保持格式一致。
  
  **使用者痛点**：
  
  
  “我曾因在 foreach 中删除元素导致程序崩溃，却一直怀疑是否代码逻辑本身有问题。”
  
  “遇到 ConcurrentModificationException 时我花了好几个小时才意识到原因竟然只是误用了 == 对比 Integer。”
  
  
  
  四、并发：线程池与锁的坑
  
  #1 Executors 创建线程池要小心
  
  
  
  PITFALL ：
  Executors.newFixedThreadPool 默认队列容量为 Integer.MAX_VALUE；Executors.newCachedThreadPool 默认线程上限也是 Integer.MAX_VALUE。高并发时任务只进不出，内存直接 OOM。
  
  
  
  
  
  
  
  SOLUTION ：
  手动配置 ThreadPoolExecutor
  java
  int corePoolSize = Runtime.getRuntime.availableProcessors;int maximumPoolSize = corePoolSize * 10;BlockingQueue workQueue =
  new ArrayBlockingQueue<>;RejectedExecutionHandler handler =
  new ThreadPoolExecutor.CallerRunsPolicy;// 或自定义策略
  
  
  
  
  
  ThreadPoolExecutor executor =
  new ThreadPoolExecutor(corePoolSize。maximumPoolSize,60L,TimeUnit.SECONDS,workQueue,handler);
  
  #2 ThreadLocal 要及时清理
  
  
  
  PITFALL ：线程池复用同一线程。如果 ThreadLocal 没清理，下一个任务会看到前一次的数据，甚至导致内存泄漏。
  
  
  
  SOLUTION ： 在 try/finally 中调用 remove
  java
  try {
  threadLocal.set;// do work
  } finally {
  threadLocal.remove;}
  
  
  
  
  
  五、POJO 与接口：数据层细节
  
  #1 POJO 属性必须用包装类型
  
  
  PITFALL ：数据库查询返回 null。用基本类型如 int,long,接收后自动拆箱即抛 NPE；RPC 调用失败返回 null 时无法区分业务错误与正常返回。
  
  SOLUTION ：POJO 属性及 RPC 参数/返回值均使用包装类型；局部变量仅用于内部计算，其实，
  
  
  #2 超大整数返回前端要 String
  
  
  PITFALL ：Java Long 最大值为 ~9e18。但 JavaScript Number 能准确表示的是 <= ~9e15。因此订单号等超长 ID 若以 Long 返回，会在前端丢失精度。
  
  SOLUTION ：统一将超长整数以 String 返回。
  
  
  
  常见问答
  
  Q: “这十几条规约，全背下来不得累死吗？说起来，”
  
  A: 不用背！优先级按> >，先守住强制级即可。再看剩下交给工具，IDEA 安装 Alibaba Java Coding Guidelines 插件。当你写违规代码时立即标红，比人肉记清单靠谱多了。
  
  Q: “现在都用 LocalDateTime/Instant 等新 API，我还需要关注 SimpleDateFormat 的坑吗？”
  
  A: 必须！老项目迁移不是一夜之间完成，大量程序仍在跑 Date + SimpleDateFormat。而且理解它为何线程不安全，你才能真正把握新 API immutable 的优势。