执行gRPC PHP代码生成命令时反复报错：系统找不到指定路径

问题重现 #

执行以下protoc命令生成gRPC PHP代码时：

protoc \
--proto_path=examples/protos \
--php_out=examples/php \
--grpc_out=examples/php \
--plugin=protoc-gen-grpc=bins/opt/grpc_php_plugin \
./examples/protos/helloworld.proto

报错：

--grpc_out: protoc-gen-grpc: The system cannot find the path specified.

去掉gRPC相关参数的命令可正常运行，protoc已加入系统PATH，composer依赖配置如下：

"require": {
  "grpc/grpc": "^v1.39.0",
  "google/protobuf": "^v3.12.2"
}

运行环境：Windows 10，PHP 7.4/8.0/8.1/8.2

排查与解决步骤 #

• 确认grpc_php_plugin的存在与格式
  Windows下的gRPC插件是带.exe后缀的可执行文件，原命令中bins/opt/grpc_php_plugin是类Unix系统的路径格式，Windows无法识别。先确认你已获取正确的Windows版本插件：

  • 若从gRPC源码编译，插件通常位于grpc\bins\opt\grpc_php_plugin.exe；
  • 若下载预编译版本，需确保下载的是Windows平台的插件，而非Linux/macOS版本。

• 修正命令中的插件路径
  使用绝对路径指定插件，注意Windows路径用正斜杠或双反斜杠避免转义问题，示例：

  protoc \
  --proto_path=examples/protos \
  --php_out=examples/php \
  --grpc_out=examples/php \
  --plugin=protoc-gen-grpc=C:/grpc/bins/opt/grpc_php_plugin.exe \
  ./examples/protos/helloworld.proto
  

• 将插件加入系统PATH
  把grpc_php_plugin.exe所在的文件夹添加到系统环境变量PATH中，之后命令可简化为：

  protoc \
  --proto_path=examples/protos \
  --php_out=examples/php \
  --grpc_out=examples/php \
  ./examples/protos/helloworld.proto
  

  protoc会自动在PATH中查找protoc-gen-grpc.exe，无需手动指定插件路径。

• 验证插件可正常执行
  直接在命令行运行grpc_php_plugin.exe（已加入PATH时）或其绝对路径，若提示“不是有效的Win32应用程序”，说明插件版本与系统不匹配，需重新编译或下载Windows版本的插件。

• 检查版本兼容性
  确保protoc、grpc_php_plugin、gRPC PHP的版本相互匹配，避免因版本差异导致的执行异常。你的gRPC PHP为1.39.0，建议使用对应版本的protoc和插件。

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