.NET Core MVC部署至Azure后Google Sheets API认证触发CGI错误

嗨，这个CGI进程终止的问题我见得太多了——本地跑好好的，一部署到Azure就崩，核心原因就是Azure环境下读取Google服务账号JSON密钥的方式和本地不一样。本地路径、权限都没限制，但Azure App Service的运行环境有自己的规则，下面给你几个针对性的解决办法：

1. 优先用Azure应用配置存储密钥（推荐最佳实践） #

别再把JSON密钥文件放在应用目录里了！Azure部署时会覆盖应用目录，而且文件权限也容易出问题。更安全可靠的方式是把密钥内容直接存在Azure的应用设置里：

• 打开你的JSON密钥文件，复制全部内容；
• 登录Azure Portal，找到你的App Service，进入「配置」→「应用程序设置」；
• 添加一个新的设置项，比如命名为GoogleServiceAccountKey，把复制的JSON内容粘贴到值里；
• 代码里直接从配置读取内容，不用再读文件：

  // 注入IConfiguration
  private readonly IConfiguration _config;
  public YourController(IConfiguration config)
  {
      _config = config;
  }
  
  public async Task<IActionResult> YourSheetAction()
  {
      var jsonKey = _config["GoogleServiceAccountKey"];
      using var stream = new MemoryStream(Encoding.UTF8.GetBytes(jsonKey));
      var credential = GoogleCredential.FromStream(stream)
                            .CreateScoped(SheetsService.Scope.Spreadsheets);
  
      // 初始化SheetsService后续逻辑...
  }
  

2. 如果一定要用文件，确保文件部署和路径正确 #

如果你坚持用文件方式，得解决两个关键问题：文件要被正确部署到Azure，代码要拿到正确的路径：

• 设置文件复制属性：右键你的JSON密钥文件，在「属性」里把「复制到输出目录」改成「始终复制」或者「如果较新则复制」，这样部署时文件会被同步到Azure的应用目录；
• 用环境变量获取正确路径：不要用相对路径，通过IWebHostEnvironment获取应用的内容根路径：

  private readonly IWebHostEnvironment _env;
  public YourController(IWebHostEnvironment env)
  {
      _env = env;
  }
  
  public async Task<IActionResult> YourAction()
  {
      var keyFilePath = Path.Combine(_env.ContentRootPath, "your-service-account-key.json");
      if (!System.IO.File.Exists(keyFilePath))
      {
          // 这里可以加日志或者错误处理，确认文件是否存在
          throw new FileNotFoundException("Google服务账号密钥文件不存在", keyFilePath);
      }
  
      using var stream = new FileStream(keyFilePath, FileMode.Open, FileAccess.Read);
      var credential = GoogleCredential.FromStream(stream)
                            .CreateScoped(SheetsService.Scope.Spreadsheets);
  }
  

• 验证文件是否存在：可以通过Azure App Service的Kudu调试工具进入命令行界面（在Azure Portal的App Service概述页里找到「高级工具」入口），用dir命令查看文件是否在目录里，用type your-service-account-key.json确认内容是否正确。

3. 远程调试时重点排查这几个点 #

既然你已经尝试远程调试，那可以聚焦这几个方向：

• 输出文件路径到日志：在代码里把要读取的文件路径打印到日志，比如：

  _logger.LogInformation("尝试读取Google密钥文件路径: {Path}", keyFilePath);
  

  然后在Azure Portal的「日志流」里查看路径是否正确，很多时候是路径写错了导致找不到文件；
• 捕获认证时的具体异常：CGI错误太笼统，要把Google认证的异常细节打出来：

  try
  {
      var credential = GoogleCredential.FromStream(stream)
                            .CreateScoped(SheetsService.Scope.Spreadsheets);
  }
  catch (Exception ex)
  {
      _logger.LogError(ex, "Google Sheets API认证失败");
      throw;
  }
  

  这样日志里会显示具体错误，比如文件权限不足、JSON格式错误、密钥过期等；
• 检查.NET Core版本：确保Azure App Service设置的.NET Core版本和本地项目的目标框架一致，版本不兼容也可能导致进程意外终止。

4. 额外提醒：密钥安全 #

不管用哪种方式，都别把JSON密钥文件提交到代码仓库里！用Azure应用配置或者Key Vault存储敏感信息，才符合云应用的安全最佳实践。

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