FileLock 是建议性锁，非强制互斥，Windows 下表现强于 Linux；必须所有进程主动配合加锁才有效，不可用于分布式场景，且需显式 release() 并避免跨 JVM 复用。
FileLock 在 Windows 和 Linux 上行为不一致，别默认它能跨进程锁文件
Java 的 FileLock 不是“你调用就一定锁住”的硬锁，它本质是 advisory lock（建议性锁），依赖底层 OS 支持和进程是否配合。Windows 下 FileChannel.lock() 会真正阻塞其他进程的同区域访问；Linux 默认用 flock() 或 fcntl()，但若另一个程序完全不用锁机制（比如直接用 cat 写文件），FileLock 就形同虚设。
常见错误现象：FileLock 返回了非 null 对象，但另一 Java 进程或 Shell 脚本仍能同时写入同一文件，导致数据错乱。
- 必须确保所有访问该文件的程序都主动使用锁机制（哪怕只是检查
tryLock()是否成功） - Linux 下推荐搭配
FileChannel.open(..., StandardOpenOption.WRITE)显式打开写通道，避免只读打开后lock()失败却无提示 - 不要在
FileInputStream/FileOutputStream上直接调用getChannel().lock()—— 它们的 channel 默认不可写，lock()可能返回 null 或抛NonWritableChannelException
lock() 和 tryLock() 选哪个？看你是想等还是想立刻失败
lock() 会阻塞当前线程直到获得锁（或被中断），tryLock() 立即返回 FileLock 或 null。两者都不是“自动重试”，也都不保证锁的语义在 JVM 崩溃后依然有效。
使用场景：日志聚合服务需串行写入共享日志文件时，用 lock() 更稳妥；而命令行工具做快速状态检查（如“这个配置文件正被编辑吗？”），用 tryLock() 避免卡住用户。
-
lock()调用前务必确保 channel 处于可读/可写状态，否则抛NonReadableChannelException或NonWritableChannelException -
tryLock()返回null≠ 错误，是正常流程分支，别把它当异常处理 - 带参数的
tryLock(long, long, boolean)支持超时和共享锁，但共享锁（shared=true）在 Windows 下不支持，调用直接抛IOException
FileLock 不能跨 JVM 生命周期，关掉进程前必须显式 release()
FileLock 是与 FileChannel 绑定的，channel 关闭、JVM 退出、甚至 GC 回收 channel 时，锁会被自动释放。但“自动释放”不是实时的——尤其在 JVM crash 或 kill -9 时，OS 层锁可能残留数秒，造成后续启动失败。
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
最容易踩的坑：在 finally 块里只 close() channel，没先 lock.release()；或者把 FileLock 存在静态变量里，以为能跨请求复用——它早随着上一个 channel 被回收了。
- 必须在业务逻辑结束、channel 关闭前调用
lock.release()，且要捕获IOException（比如锁已被其他进程释放） - 不要缓存
FileLock实例，每次操作都重新tryLock()或lock() - 测试时用
lsof -p（Linux）或 Process Explorer（Windows）确认锁是否真实存在，别只信 return 值
用 FileLock 做分布式锁？别碰，它根本不是为这个设计的
FileLock 只作用于本地文件系统，NFS、SMB、Docker volume 等场景下行为未定义。很多团队踩过坑：容器内 Java 应用对挂载的 NFS 目录加锁，结果多个实例同时拿到 FileLock，因为 NFS 服务器根本不转发 flock 请求。
性能影响很小，但兼容性风险极大。一旦部署环境从单机切到容器或云盘，锁立即失效。
- 涉及多节点协作的场景，改用 Redis 的
SET key value NX PX或 ZooKeeper 临时节点 - 如果坚持用文件锁，只限于单机多进程协作，且文件路径必须是本地 ext4/xfs，避开网络文件系统
- CI/CD 流水线中跑集成测试时，记得在 Dockerfile 里用
mount -t tmpfs挂内存盘，避免 NFS 干扰
事情说清了就结束。真正难的从来不是怎么调 lock()，而是判断此刻到底需不需要锁、谁和谁之间要互斥、以及当锁失效时你的程序还能不能安全降级。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
