Google Speech接口部署IIS后遇未认证错误及环境变量配置问题

看起来你遇到了两个典型的Google Cloud API认证坑，都是部署场景下容易踩的问题，我来帮你逐一排查解决：

问题1：IIS部署后出现Unauthenticated错误 #

错误信息：

Method:Status(StatusCode=Unauthenticated, Detail="Getting metadata from plugin failed with error: Exception occurred in metadata credentials plugin.")

这个错误出现在speech.Recognize(SpeechConfig, RecognitionAudio.FromFile(fileToProcess))行，核心原因是IIS应用池的运行身份无法正确获取Google认证凭证，常见解决办法如下：

• 直接在代码中指定凭证文件（最可靠方案）
  依赖环境变量在IIS中常因进程隔离、权限问题失效，不如直接硬编码凭证路径（注意别把凭证文件提交到代码仓库）：

  // 替换成你的服务账号JSON文件绝对路径
  var credentialPath = @"C:\secure-folder\your-service-account.json";
  var credential = GoogleCredential.FromFile(credentialPath);
  var speechClient = SpeechClient.Create(credential);
  
  // 用speechClient调用识别方法替代原代码
  var speechResponse = speechClient.Recognize(SpeechConfig, RecognitionAudio.FromFile(fileToProcess));
  

• 给IIS应用池添加凭证文件权限
  若坚持用环境变量，需给应用池运行身份加文件读取权限：

  1. 找到你的应用池名称（IIS管理器 → 应用池）
  2. 右键凭证JSON文件 → 属性 → 安全 → 编辑 → 添加
  3. 输入IIS AppPool\{你的应用池名称}，检查名称后确定，给该用户添加读取和执行权限

• 刷新IIS的环境变量
  IIS应用池进程不会自动读取新环境变量，设置GOOGLE_APPLICATION_CREDENTIALS后，需打开命令提示符运行iisreset重启IIS，若无效再重启服务器确保变量生效

问题2：另一台机器设置环境变量后仍报错Application Default Credentials are not available #

提示明确说凭证不可用，即使设了环境变量，大概率是以下原因：

• 环境变量未被进程读取
  设置变量后必须重启运行程序的进程（比如Visual Studio、控制台、IIS），进程只在启动时读取变量，修改后不会自动生效。可以打开命令提示符验证：

  echo %GOOGLE_APPLICATION_CREDENTIALS%
  

  确认输出路径正确且文件存在。

• 环境变量用了相对路径
  必须用绝对路径，比如C:\credentials\service-account.json，不能用./service-account.json这类相对路径，否则程序找不到文件。

• 运行程序的用户无文件权限
  比如你用管理员身份设了变量，但程序用普通用户运行，普通用户可能没权限访问凭证所在文件夹，给运行用户添加读取权限即可。

• 兜底方案：代码指定路径
  和第一个问题一样，直接在代码中指定凭证路径，绕过环境变量的各种问题，适合快速排查和稳定部署。

通用检查项 #

不管哪种场景，先确认：

• Google Cloud控制台中Cloud Speech-to-Text API已启用
• 服务账号JSON对应的账号拥有Speech-to-Text Editor或更高权限角色
• 凭证文件未被篡改，内容是有效的服务账号密钥

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