grpc-kotlin编译Proto生成Kotlin存根时出现引用未解析问题

1. 修正Gradle Protobuf插件配置 #

你当前的生成任务把grpckt和kotlin生成器的配置位置搞反了，这会导致生成的类包结构混乱，引发导入错误。正确的配置逻辑是：

• 在builtins中配置官方Protobuf Kotlin生成器，负责生成Proto数据类
• 在plugins中配置gRPC-Kotlin生成器，负责生成gRPC Stub类

修正后的protobuf配置块：

protobuf {
    protoc {
        artifact = "com.google.protobuf:protoc:3.21.12" // 和protobuf-kotlin版本对齐
    }

    plugins {
        grpckt {
            artifact = "io.grpc:protoc-gen-grpc-kotlin:1.3.0:jdk8@jar"
        }
    }

    generateProtoTasks {
        all().forEach { task ->
            // 配置官方Kotlin生成器（生成Proto数据类）
            task.builtins {
                kotlin {
                    option 'lite'
                }
            }
            // 配置gRPC-Kotlin生成器（生成Stub类）
            task.plugins {
                grpckt {
                    option 'lite'
                }
            }
        }
    }
}

2. 统一依赖版本，消除冲突 #

确保所有相关依赖版本兼容，避免因版本不一致导致的类加载问题：

• protoc版本必须和com.google.protobuf:protobuf-kotlin版本完全一致
• grpc-kotlin-stub版本要和protoc-gen-grpc-kotlin版本一致
• 不要同时引入grpc-protobuf和grpc-protobuf-lite，二者二选一即可（lite版本更适合轻量化场景）

修正后的dependencies块：

dependencies {
    // gRPC Kotlin核心依赖
    implementation("io.grpc:grpc-kotlin-stub:1.3.0")
    implementation("io.grpc:grpc-okhttp:1.47.0")
    implementation("io.grpc:grpc-protobuf-lite:1.47.0")
    
    // Protobuf Kotlin依赖
    implementation("com.google.protobuf:protobuf-kotlin:3.21.12")
}

3. 检查Proto文件的包与导入规则 #

确保所有Proto文件的package声明正确，跨文件导入时使用完整的Proto包路径，示例：

package com.example.myapp.proto;

import "com/example/myapp/other_service.proto";

4. 清理并重新构建 #

执行以下命令清理旧的生成文件，重新触发编译：

./gradlew clean generateProto build

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