【Java踩坑笔记】52_总结篇：Java踩坑的10条黄金法则

52 | 总结篇Java 踩坑的 10 条黄金法则摘要52 篇文章、8 个辑、覆盖 Java 基础到生产实战。本文把最核心的 10 条法则提炼出来方便你记忆和团队分享。一、黄金法则背诵版法则 1对象比较一律用equals基本类型int、long...→ 用 引用类型比较值相等 → 用 equals String 比较 → 永远 equals别用 包装类型Integer、Long...→ equals 或先拆箱相关文章第 01 篇法则 2浪费BigDecimal禁止用double构造#new BigDecimal(0.1) → ❌ 精度已丢失 new BigDecimal(0.1) → ✅ 正确 BigDecimal.valueOf(0.1) → ✅ 正确内部先转 String相关文章第 03 篇法则 3synchronized锁定的是对象不是代码块#String、Integer、Boolean 不要做锁对象可能共享 锁对象必须是 private final 的 缩小锁范围只包住需要互斥的代码相关文章第 16 篇法则 4i不是原子操作高并发用Atomic类#i → 读 → 改 → 写三步不是原子 低并发 → AtomicInteger 高并发 → LongAdderJava 8相关文章第 18 篇法则 5Transactional自调用不生效必须拆 Service#同一个类里调用 Transactional 方法 → ❌ 不生效 拆到另一个 Service → ✅ 经过代理 Exception 类型 → 必须指定 rollbackFor Exception.class相关文章第 32 篇法则 6集合框架先想清楚再选#List 查多改少 → ArrayList List 头插/头删多 → LinkedList Map 高频查找 → HashMap Map 需要排序 → TreeMap 并发 Map → ConcurrentHashMap相关文章第 09 ~ 15 篇法则 7线程池禁止用Executors创建#✅ 用 ThreadPoolExecutor 手动创建 ✅ 队列必须有界防止 OOM ✅ IO 任务用独立线程池别占满 commonPool ✅ 提交任务必须处理异常submit 后必须 get相关文章第 19、20、24 篇法则 8JVM 参数不只设-Xmx#-Xmx 只限制堆 Metaspace → -XX:MaxMetaspaceSize DirectBuffer → -XX:MaxDirectMemorySize 容器化 → -XX:UseContainerSupportJDK 8u191相关文章第 29 篇法则 9MyBatis 能用#{}就不用${}##{} → ? 占位符预编译安全 ✅ ${} → 字符串替换有注入风险 ❌ 动态表名用 ${} 时必须白名单校验相关文章第 41 篇法则 10生产问题保留现场优先于重启#OOM → -XX:HeapDumpOnOutOfMemoryError自动 dump 死锁 → jstack pid dump.txt保留线程堆栈 慢查询 → 开慢查询日志slow_query_log 重启前 → 一定先 dump 现场相关文章第 50、51 篇二、记忆卡片速查#第一辑基础语法篇8 篇#核心记忆点一句话 vs equals 比地址equals 比值自动拆箱包装类型运算前必须判空BigDecimal禁止用 double 构造String 循环内拼接必须用 StringBuilderequals hashCode必须同时重写否则 HashMap 失效try-finallyfinally 里别写 return泛型擦除运行期拿不到泛型类型枚举 ordinal别用用自定义 code 字段第三辑并发编程篇10 篇#核心记忆点一句话synchronized锁定对象不是代码块volatile保证可见性不保证原子性i不是原子操作线程池 submit异常被吞必须 get()线程池队列必须有界防止 OOMCountDownLatchcountDown() 必须放 finallyThreadLocal用完必须 remove()防止泄漏DCL 单例必须加 volatileCompletableFuture生产环境必须指定自定义线程池锁选型简单用 synchronized高级用 ReentrantLock三、团队落地建议#3.1 代码评审 Checklist#把这份 Checklist 加入团队的 PR 模板Java 代码评审 Checklist踩坑预防版 □ 1. 字符串比较是否用了 equals禁止 □ 2. BigDecimal 是否用了 String 构造禁止 double 构造 □ 3. 包装类型参与运算前是否判空防止 NPE □ 4. 重写 equals 是否同时重写了 hashCode □ 5. ArrayList 循环删除是否用了 removeIf禁止 foreach 里 remove □ 6. 线程安全类是否选对了ConcurrentHashMap vs HashMap □ 7. 锁对象是否是 private final 的禁止 String/Boolean 做锁 □ 8. i 在并发场景下是否用了 AtomicInteger □ 9. Transactional 方法是否是 public 的是否避免了自调用 □ 10. 线程池是否用 ThreadPoolExecutor 手动创建禁止 Executors □ 11. 提交到线程池的任务内部是否有 try-catch □ 12. ThreadLocal 是否在 finally 里 remove() 了 □ 13. Async 方法是否加了 EnableAsync是否避免了自调用 □ 14. MyBatis 的 SQL 是否用了 #{}禁止用 ${} 拼 WHERE 条件 □ 15. 分页查询偏移量是否超过了 10000超过了要用延迟关联优化 □ 16. 生产环境 -Xmx 是否同时配了 MaxMetaspaceSize 和 MaxDirectMemorySize □ 17. 日志打印对象时toString() 是否可能递归 □ 18. 用 SimpleDateFormat 的地方是否线程安全建议迁移到 DateTimeFormatter □ 19. 实现 Serializable 的类是否写了 serialVersionUID □ 20. OOM 参数是否加了 -XX:HeapDumpOnOutOfMemoryError3.2 IDEA 必装插件#插件作用Alibaba Java Coding Guidelines扫描阿里开发手册规约SonarLint静态代码分析提前发现 bugMyBatisXMyBatis XML 和 Mapper 互跳警告 ${} 风险Lombok减少样板代码自动生成 *ArgsConstructor3.3 新人入职培训#把前 8 篇基础语法篇作为新人必读要求通读 8 篇文章每篇文章后面附 3 道选择题自测排入新人入职第一周的培训计划四、专栏使用建议#4.1 作为团队知识库#建议存放位置 - 腾讯文档方便协作、搜索 - 公司内网 WikiConfluence / 飞书文档 - 个人博客Hexo / HugoSEO 友好4.2 持续更新#Java 在演进坑也在变化。建议每遇到一个新坑写一篇新文章Java 新版本每 6 个月一个 LTS发布后检查是否有新的踩坑场景读者留言里的高频问题补充到对应文章里4.3 配套练习#建议为每篇文章写一个「课后练习」JUnit 测试让读者运行测试时直观感受 bug// 第 01 篇配套练习TestpublicvoidtestStringComparison(){Strings1newString(hello);Strings2hello;assertFalse(s1s2);// 预期 比较失败assertTrue(s1.equals(s2));// 预期equals 成功}五、结语#踩坑不可怕可怕的是在同一个坑里跌倒两次。这份专栏的目标是让你把「不知道有这个坑」变成「我知道这里有坑绕过去」。Java 还在演进新的坑会不断出现。保持好奇心保持对底层原理的追问你就能在大部分坑出现之前就识别它们。祝编码愉快生产环境 0 Bug。全专栏完。52 篇文章8 个辑祝你踩坑越来越少。附录文章索引快速查阅#辑文章范围核心主题第一辑基础语法篇01 ~ 08 vs equals、BigDecimal、String、枚举 ordinal第二辑集合框架篇09 ~ 15CME、HashMap 扩容、HashSet 可变对象、Stream 并行流第三辑并发编程篇16 ~ 25synchronized、volatile、i、线程池、ThreadLocal、DCL、CompletableFuture第四辑JVM 与性能篇26 ~ 31toString 递归、反射性能、finalize、OOM、Soft/Weak Reference、Lambda this第五辑Spring/Spring Boot 篇32 ~ 39Transactional、Field 注入、Async、Value、循环依赖、AOP、配置加载第六辑数据库与 MyBatis 篇40 ~ 44PreparedStatement null、#{} vs ${}、连接池、LIMIT 优化、保留字第七辑日常开发技巧篇45 ~ 49日志 toString、switch 穿透、SimpleDateFormat、Optional、serialVersionUID第八辑综合实战篇50 ~ 52OOM 排查、死锁定位、总结篇