【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 排查、死锁定位、总结篇

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

相关推荐

【langgraph 从入门到精通graphApi 篇】消息处理与工具集成

Premium 推广卡片：金色边框 + 阴影 + 立即开通按钮

Claude 连不上数据库？MCP 服务器 30 分钟从零搭一个

更多资讯

如何快速上手tdl：从零开始的Telegram文件下载教程

tdl单文件启动指南：为什么它能比官方客户端更快？

Lab Hardware CAD 制造极限指南：为科研硬件选对工艺、公差与材料

CANN/ge算子编译取消注册接口

Vue3 + TypeScript 类型安全实战：告别 any 的完整指南

CANN/GE算子编译接口

今日更新

CopilotKit Vue Demo 与 React Demo 的 Parity 实现指南：路由、运行时端点与交互语义的全框架对齐

Harbor RBAC 实战：db_auth 模式下非管理员用户管理项目成员的完整验证与权限模型解析

STM32平衡车纯平衡程序从拆包到参数整定的完整调试指南

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？