必须为缓存设置容量上限和自动清理机制：.maximumsize(5000)或.maximumweight(100_000)，搭配.expireafterwrite与.expireafteraccess过期策略，启用.recordstats()监控驱逐指标，并检查键值对象避免内存泄漏。
核心解决思路很明确：必须为缓存设置容量上限和自动清理机制，不能让它无限制增长。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即加容量限制
无上限缓存就像没有闸门的水库，数据只进不出。Caffeine 默认不限大小，必须显式配置：
✅ 正确写法：.maximumSize(5000) —— 限制最多存 5000 个条目.maximumWeight(100_000) —— 按权重（比如对象大小）控制总内存占用
不设这个，哪怕加了过期策略，也挡不住突发流量把缓存撑爆。
搭配合理的过期策略
光限数量不够，冷数据长期滞留也会浪费内存：.expireAfterWrite(30, TimeUnit.MINUTES) —— 写入后 30 分钟自动失效.expireAfterAccess(10, TimeUnit.MINUTES) —— 最后一次访问后 10 分钟失效
两者可同时使用，优先触发者生效。避免用 refreshAfterWrite 单独替代，它不释放内存，只后台刷新。
启用统计与监控
加了限制不代表万事大吉，得验证是否真正生效：.recordStats() 开启统计
运行中调用 cache.stats() 查看 hitRate、evictionCount 等指标
如果 evictionCount 长期为 0，说明上限没起作用，可能键设计有误（如 key 是 new Object()）、或缓存根本没被复用
检查键值对象本身
缓存项自己也可能引发泄漏：
键对象避免使用匿名类、非静态内部类（会隐式持外部类引用）
值对象别持有大数组、未关闭流、线程池等长生命周期资源
必要时用 WeakReference 包装值，但慎用——GC 时机不可控，可能频繁击穿
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
