17370845950

在 gradle 7.6 中将 `mainclassname` 替换为 `mainclass.set()` 后出现“could not get unknown property 'mainclass'”错误，通常是因 gradle wrapper 版本过低（低于 6.4）导致 api 不可用，需统一并升级 wrapper 版本。

Gradle 自 6.4 版本起引入了基于 Property 的新型应用主类配置方式，即 application.mainClass.set("com.example.Main")，以替代已弃用的 mainClassName 字符串属性。但该 API 仅在 Gradle 6.4 及以上版本中可用。若项目中存在旧版 Gradle Wrapper（如 6.3 或更早），即使本地安装了 Gradle 7.6，执行 ./gradlew build 时仍会使用 Wrapper 指定的旧版本，从而触发 Could not get unknown property 'mainClass' 错误。

✅ 正确配置示例（适用于 Gradle ≥ 6.4）：

plugins {
    id 'application'
    id 'java'
}

application {
    mainClass.set('com.example.HelloWorld') // 注意：类名必须是全限定名（含包路径）
}

⚠️ 关键检查与修复步骤：

1. 确认实际运行的 Gradle 版本
   运行以下命令，检查 Wrapper 使用的版本：

   ./gradlew --version

   若输出版本

2. 升级 Gradle Wrapper 至 7.6
   在项目根目录执行（需先确保本地 gradle 命令可用）：

   ./gradlew wrapper --gradle-version 7.6

   执行后，gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl 将自动更新为 https\://services.gradle.org/distributions/gradle-7.6-bin.zip。

3. 临时回退兼容（仅调试用）
   若升级 Wrapper 前需快速验证构建，可暂时恢复旧语法（Gradle 7.6 仍兼容，但会打印弃用警告）：

   application {
       mainClassName = 'com.example.HelloWorld' // 兼容写法，非推荐长期使用
   }

? 补充说明：

• mainClass.set() 是 RegularFileProperty 类型的 Property，支持延迟求值（如 mainClass.set(project.provider { 'com.example.' + project.name })），更符合 Gradle 的惰性配置理念；
• 类名务必使用完整包路径（如 com.example.App），不可省略包名或使用相对路径；
• 若使用 Kotlin DSL（build.gradle.kts），应写作 application.mainClass.set("com.example.App")。

完成 Wrapper 升级并清理缓存后，执行 ./gradlew clean build 即可正常构建。建议团队统一通过 Wrapper 管理 Gradle 版本，避免环境不一致引发的隐性问题。