如何让Windows Forms应用通过代理访问Google Firestore？

针对你的Windows Forms应用在代理网络下无法访问Firestore的问题，这里有几个几乎不需要修改现有业务代码的解决方案：

方案1：通过系统环境变量配置代理（零代码改动） #

Google的.NET客户端库（包括Google.Cloud.Firestore和Google.Cloud.Storage.V1）会自动读取系统的HTTP_PROXY和HTTPS_PROXY环境变量，这是最省心的方案，完全不用碰代码：

设置方式： #

• 临时生效（仅当前会话）：打开命令提示符（CMD），执行以下命令（替换为你的代理地址和端口，有认证需求的话加上用户名密码）：

  set HTTP_PROXY=http://proxy.example.com:8080
  set HTTPS_PROXY=http://proxy.example.com:8080
  

  然后从这个CMD窗口启动你的Windows Forms应用即可。

• 永久生效：在Windows系统环境变量中添加配置：

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」区域点击「新建」，分别添加：
     • 变量名：HTTP_PROXY，变量值：http://[用户名:密码@]代理地址:端口
     • 变量名：HTTPS_PROXY，变量值：http://[用户名:密码@]代理地址:端口
  3. 重启应用后，客户端库会自动加载这个代理配置。

方案2：代码中全局配置代理（仅初始化时改动一次） #

如果环境变量配置不生效（比如代理需要特殊认证或系统环境有限制），可以在应用启动时全局配置Firestore客户端的代理，不需要修改每个业务方法：

实现步骤： #

1. 在应用入口（比如Program.cs的Main方法，或者主窗体的构造函数）添加全局配置代码：

   using System.Net;
   using Google.Cloud.Firestore;
   using Grpc.Net.Client;
   
   // 定义全局静态类存储配置好的客户端
   public static class GlobalFirestoreClient
   {
       public static FirestoreClient Instance { get; set; }
   }
   
   // 在应用启动时执行一次配置
   var proxy = new WebProxy("http://your-proxy-address:port")
   {
       // 代理需要认证的话，取消注释并替换为实际信息
       // Credentials = new NetworkCredential("proxy-username", "proxy-password")
   };
   
   var httpHandler = new HttpClientHandler
   {
       Proxy = proxy,
       UseProxy = true
   };
   
   GlobalFirestoreClient.Instance = new FirestoreClientBuilder
   {
       ChannelOptions = new GrpcChannelOptions
       {
           HttpHandler = httpHandler
       }
   }.Build();
   

2. 修改你的InsertData方法，仅改动一行代码复用全局客户端：

   private async Task InsertData(string project, Dictionary<string, object> user, String empid) 
   { 
       // 使用全局配置好的客户端创建FirestoreDb
       FirestoreDb db = FirestoreDb.Create(project, GlobalFirestoreClient.Instance); 
       DocumentReference docRef = db.Collection("employees").Document(empid); 
       label1.Text += "Inserting Data to Google Firestore........ \n"; 
       WriteResult x = await docRef.SetAsync(user); 
       label1.Text += "Data Inserted successfully for EmpNo :- "+empid+ " \n"; 
   }
   

补充说明： #

• 如果同时使用Google.Cloud.Storage.V1，可以用完全一致的逻辑配置StorageClientBuilder来设置代理。
• 优先推荐方案1，完全符合你「尽量少修改现有代码」的需求。

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