如何配置多模块项目实现Android与Spring共存并解决Gradle错误？

错误原因与修复步骤 #

1. 根项目buildscript缺少仓库配置 #

你遇到的错误是因为根项目的build.gradle.kts中，buildscript块只声明了依赖，但未指定仓库地址，Gradle无法找到kotlin-gradle-plugin。修改根项目的build.gradle.kts，补充仓库配置：

buildscript {
    repositories {
        mavenCentral()
        google() // Android插件需从Google仓库获取
    }
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.0")
        classpath("com.android.tools.build:gradle:7.4.2") // 添加匹配compileSdk的Android Gradle插件
    }
}

// 为所有子模块统一配置仓库，避免重复声明
allprojects {
    repositories {
        mavenCentral()
        google()
    }
}

2. 移除Web模块独立的setting.gradle.kts #

根项目的settings.gradle.kts已经管理了所有子模块，Web模块自身的setting.gradle.kts会导致配置冲突，直接删除即可。

3. 统一Kotlin版本 #

确保所有模块使用相同的Kotlin版本，避免兼容性问题。修改Web模块的build.gradle.kts，将Kotlin版本从1.7.22改为1.8.0：

plugins {
    id("org.springframework.boot") version "3.0.1"
    id("io.spring.dependency-management") version "1.1.0"
    kotlin("jvm") version "1.8.0"
    kotlin("plugin.spring") version "1.8.0"
    kotlin("plugin.jpa") version "1.8.0"
}

4. （可选）升级Android依赖到AndroidX #

旧的com.android.support库已停止维护，建议升级到AndroidX生态，修改Android模块的build.gradle.kts：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
}

android {
    namespace = "pl.mattiahit.myrestaurant.mobile"
    compileSdk = 33 // 升级到较新的SDK版本

    defaultConfig {
        applicationId = "pl.mattiahit.myrestaurant.mobile"
        minSdk = 24
        targetSdk = 33
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" // 替换为AndroidX测试Runner
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
}

多模块项目配置参考内容 #

• Gradle官方多项目构建文档：重点学习根项目与子模块的配置共享、任务依赖、模块间引用等核心逻辑。
• Spring Boot多模块实践：了解如何拆分Spring项目的API层、服务层、持久层，通过Spring依赖管理插件统一版本。
• Android多模块最佳实践：掌握Android项目中应用模块与库模块的划分、资源共享、构建变体配置，注意Android与JVM模块的编译差异。

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