Kotlin+gRPC项目Docker容器构建失败：protoc文件不存在求助

构建Kotlin+gRPC项目的Docker容器时，持续遇到以下错误：

java.io.IOException: Cannot run program "/home/gradle/.gradle/caches/modules-2/files-2.1/com.google.protobuf/protoc/3.20.3/898c37cfe230a987c908cff24f04a58d320578f1/protoc-3.20.3-linux-x86_64.exe": error=2, No such file or directory

已尝试在Dockerfile中提前下载解压protoc，但问题未解决：

RUN curl -LO https://github.com/protocolbuffers/protobuf/releases/download/v3.20.3/protoc-3.20.3-linux-x86_64.zip
RUN unzip -q protoc-3.20.3-linux-x86_64.zip

项目build.gradle中的protobuf配置如下：

protobuf {
    protoc {
        artifact = "com.google.protobuf:protoc:3.20.3"
    }
    plugins {
        id("grpc") {
            artifact = "io.grpc:protoc-gen-grpc-java:1.46.0"
        }
        id("grpckt") {
            artifact = "io.grpc:protoc-gen-grpc-kotlin:0.2.0:jdk7@jar"
        }
    }
    generateProtoTasks {
        ofSourceSet("main").forEach {
            it.plugins {
                // Apply the "grpc" plugin whose spec is defined above, without options.
                id("grpc")
                id("grpckt")
            }
        }
    }
}

问题根源 #

Gradle的protobuf插件默认从Maven仓库拉取protoc时，在Linux环境下错误匹配了带.exe后缀的Windows版本可执行文件；同时手动下载的protoc未配置到Gradle的查找路径，插件仍会读取缓存中的错误文件。

解决方案 #

方案1：指定本地protoc路径

修改build.gradle的protoc配置，指向手动下载的可执行文件：

protobuf {
    protoc {
        // 替换为解压后protoc的绝对路径，示例为系统全局路径
        path = "/usr/local/bin/protoc"
    }
    // 其余plugins、generateProtoTasks配置保持不变
}

同时在Dockerfile中把protoc移到系统可执行路径并赋予权限：

RUN curl -LO https://github.com/protocolbuffers/protobuf/releases/download/v3.20.3/protoc-3.20.3-linux-x86_64.zip
RUN unzip -q protoc-3.20.3-linux-x86_64.zip -d /usr/local
RUN chmod +x /usr/local/bin/protoc

方案2：强制拉取Linux版本protoc

修改build.gradle中protoc的artifact配置，明确指定Linux平台的classifier，避免插件错误匹配：

protobuf {
    protoc {
        artifact = "com.google.protobuf:protoc:3.20.3:linux-x86_64"
    }
    // 其余plugins、generateProtoTasks配置保持不变
}

此方式无需手动下载protoc，Gradle会自动拉取对应Linux版本的可执行文件，彻底避免.exe后缀问题。

额外注意事项 #

• 确保Docker基础镜像是Linux环境（如openjdk:17-alpine、gradle:7-jdk17等），不要混用Windows相关镜像；
• 构建前清理Gradle缓存，避免残留错误文件：

RUN rm -rf /home/gradle/.gradle/caches/modules-2/files-2.1/com.google.protobuf/protoc/3.20.3

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