如何在IntelliJ中追踪Java项目构建时特定零长度文件的创建？

1. 切换到NIO API断点排查 #

很多现代框架（包括Gradle）已不再依赖File类的旧API，改用Java NIO的Files类操作文件。直接在以下方法设置条件断点：

• java.nio.file.Files.createFile(Path, FileAttribute<?>...)：条件设为path.getFileName().toString().equals("你的目标文件名")
• java.nio.file.Files.write(Path, byte[], OpenOption...)：同样添加文件名匹配条件，零长度文件大概率是写入空字节数组导致的

2. 通过Gradle详细日志定位任务 #

执行构建时添加--info参数输出详细操作日志，直接搜索目标文件名：

./gradlew build --info

日志会记录每个Gradle任务的文件操作细节，找到关联任务后，再针对性排查任务的实现逻辑（包括自定义任务或第三方插件）

3. 系统级文件监控追踪进程 #

用系统工具直接监控文件创建事件，定位发起进程：

• Windows：使用Process Monitor（ProcMon），设置过滤规则：路径包含目标文件名、操作类型为CreateFile，启动构建后查看触发事件的进程
• Linux/macOS：执行inotifywait命令监控目标目录：

inotifywait -m -e create /path/to/your/project | grep "你的目标文件名"

拿到进程ID后，在IntelliJ中attach到该进程进行调试

4. 临时添加Gradle拦截逻辑 #

编写极简Gradle脚本，拦截所有文件创建操作并标记目标文件：

// 加到根目录build.gradle中
gradle.taskGraph.beforeTask { task ->
    task.doFirst {
        def fileOps = services.get(org.gradle.api.file.FileSystemOperations)
        fileOps.createFile {
            eachFile { details ->
                if (details.file.name == "你的目标文件名") {
                    println "触发创建的任务：${task.path}"
                    // 抛出异常直接中断构建，快速定位
                    throw new RuntimeException("找到目标文件创建点")
                }
            }
        }
    }
}

执行构建后，控制台会输出触发文件创建的任务路径，直接定位到对应逻辑

5. 排查Gradle增量构建缓存 #

零长度文件可能是增量构建的缓存产物，先执行./gradlew clean build全量构建，若文件消失，说明是某任务的增量输入输出配置异常，重点排查该任务的缓存逻辑

内容的提问来源于stack exchange，提问作者Bob Goldberg