OpenRewrite SystemOutToLogging Recipe在Gradle项目中不生效求助

以下是几个常见的排查方向和解决步骤：

1. 确认依赖与插件配置是否完整 #

首先要确保build.gradle里正确引入了OpenRewrite插件和对应的Logging Recipe依赖，版本要兼容：

plugins {
    id 'java'
    id 'org.openrewrite.rewrite' version '6.16.0' // 建议使用官方推荐的稳定版本
}

rewrite {
    activeRecipe("org.openrewrite.java.logging.SystemOutToLogging")
}

dependencies {
    // 通过BOM统一管理Recipe版本，避免版本冲突
    rewrite platform("org.openrewrite.recipe:rewrite-recipe-bom:2.6.0")
    // 引入包含SystemOutToLogging的Recipe包
    rewrite "org.openrewrite.recipe:rewrite-logging-frameworks"
    // 确保项目本身有日志框架依赖（比如SLF4J），否则转换后的代码会报错
    implementation 'org.slf4j:slf4j-api:1.7.36'
}

如果漏了rewrite-logging-frameworks依赖，Recipe根本不会被加载，自然不会生效。

2. 检查代码是否符合Recipe的匹配规则 #

SystemOutToLogging只处理直接调用的System.out输出语句，以下情况不会被转换：

// 不会被转换：通过变量引用System.out
PrintStream customOut = System.out;
customOut.println("Test");

// 不会被转换：自定义了同名的out对象
class Test {
    private PrintStream out;
    public void log() {
        out.println("Hello");
    }
}

只有类似System.out.println("Hello");这种直接调用的写法才会被转换为对应的日志框架调用（默认是SLF4J的LOGGER.info()）。

3. 查看任务执行的详细日志 #

执行./gradlew rewriteRun --info，通过详细日志确认：

• Recipe是否成功加载
• 目标Java文件是否被扫描到
• 是否有文件被排除、代码语法错误等导致跳过处理的情况

如果你的Java文件不在Gradle默认的src/main/java目录下，需要在build.gradle里配置sourceSets指定源码路径：

sourceSets {
    main {
        java {
            srcDirs = ['custom-src-directory']
        }
    }
}

4. 排查是否有排除规则拦截了文件 #

检查rewrite配置里有没有exclude规则，比如如果目标文件在test目录，但配置排除了test路径，就不会被处理：

rewrite {
    activeRecipe("org.openrewrite.java.logging.SystemOutToLogging")
    exclude("**/test/**") // 确认这个规则没有覆盖你的目标文件
}

5. 用预览任务验证预期变更 #

先执行./gradlew rewriteDryRun，这个任务会生成本地报告，显示所有预期的代码变更。如果报告里没有变更，说明要么代码不匹配Recipe规则，要么配置有问题；如果报告里有变更但rewriteRun没生效，试试执行./gradlew clean rewriteRun清除缓存后再运行。

内容的提问来源于stack exchange，提问作者Bhavya Penumarthi