Ubuntu Docker构建脚本中protoc-gen-grpc-web安装与报错解决问询

问题场景 #

在Ubuntu系统编写Docker镜像构建脚本时，执行以下命令：

protoc -I. graph_endpoint.proto --grpc-web_out=import_style=commonjs,mode=grpcwebtext:.

出现报错：

protoc-gen-grpc-web: program not found or is not executable
--grpc-web_out: protoc-gen-grpc-web: Plugin failed with status code 1.

已尝试将下载的protoc-gen-grpc-web-1.4.2-linux-x86_64放置在宿主机/usr/local/bin/protoc-gen-grpc-web并设置可执行权限，但问题依旧。

解决方法 #

1. 在Docker容器内单独安装插件 #

你可能误将插件安装在宿主机，但Docker镜像构建过程是在容器环境中执行的，宿主机文件不会自动同步到容器内。需在Dockerfile中添加插件安装步骤：

# 先安装protoc依赖
RUN apt-get update && apt-get install -y --no-install-recommends protobuf-compiler

# 下载并安装grpc-web插件
RUN wget -O /usr/local/bin/protoc-gen-grpc-web https://github.com/grpc/grpc-web/releases/download/1.4.2/protoc-gen-grpc-web-1.4.2-linux-x86_64 \
    && chmod +x /usr/local/bin/protoc-gen-grpc-web

2. 验证容器内插件状态 #

在Dockerfile中添加验证命令，排查路径和权限问题：

# 检查插件是否在PATH中
RUN which protoc-gen-grpc-web
# 检查插件可执行性
RUN protoc-gen-grpc-web --version

若which命令无输出，说明插件所在目录不在容器的PATH中，可手动添加：

ENV PATH="/usr/local/bin:${PATH}"

3. 检查版本兼容性 #

确保protoc版本与grpc-web插件版本匹配：

• 执行protoc --version查看容器内protoc版本
• grpc-web 1.x系列需搭配protoc 3.12及以上版本，若版本不兼容，需升级protoc或更换对应版本的grpc-web插件

4. 权限与路径排查 #

若插件权限已设置但仍无法执行，可尝试：

• 将插件移动到/usr/bin目录（部分容器环境默认PATH优先包含此目录）
• 检查容器内/usr/local/bin的目录权限，确保当前用户有执行权限

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