Blazor WASM控制器拆分至独立服务项目：利弊与实现方法咨询

一、方案优势 #

• 彻底解耦：Server项目不再依赖Client，业务逻辑与前端UI完全分离，WebAPI可独立迭代，不受Blazor Client版本更新的束缚
• 多端复用：独立服务项目可直接为移动应用、外部第三方提供标准化API，无需为不同客户端重复开发接口逻辑
• 灵活部署扩容：服务项目可单独部署，根据API访问量独立调整资源，比耦合在Server项目中更具弹性
• 职责清晰划分：服务项目专注于业务逻辑与API暴露，Server转型为纯Blazor静态资源托管，Client专注UI实现，各模块分工明确
• 测试效率提升：独立服务可单独编写单元测试、集成测试，无需依赖Blazor Client环境，测试流程更顺畅

二、方案劣势 #

• 项目复杂度上升：新增独立服务项目后，解决方案的项目数量增加，依赖管理、部署流程会更繁琐
• 初期迁移成本：需要将现有控制器、关联业务逻辑从Server项目迁移到新服务，涉及代码重构、依赖调整，需投入一定时间
• 跨项目调试难度：调试时需同时运行Client、Server、独立服务多个项目，比单一Server项目调试更复杂
• 额外配置工作：需单独配置服务项目的API路由、CORS、认证授权规则，还要确保Server与服务项目间的通信正常

三、实施步骤 #

1. 创建独立服务项目 #

• 在解决方案中添加ASP.NET Core Web API项目（命名如YourApp.Services）
• 删除项目默认的WeatherForecast相关文件，保留Program.cs、appsettings.json等基础配置文件

2. 迁移控制器与业务逻辑 #

• 将Server项目中所有继承ControllerBase的WebAPI控制器复制到新服务项目
• 迁移控制器依赖的业务逻辑、数据访问代码：
  • 若业务逻辑原在Server项目，可移至服务项目，或提取到Shared项目供多项目复用
  • 确保服务项目引用必要的NuGet包（如Entity Framework Core、认证相关包等）
  • 调整命名空间，确保代码编译通过

3. 解除Server与Client的依赖 #

• 在Server项目中移除对Client项目的引用
• 修改Server项目的Program.cs，将其调整为纯静态文件托管配置：

  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddRazorPages();
  builder.Services.AddControllersWithViews();
  
  var app = builder.Build();
  
  if (!app.Environment.IsDevelopment())
  {
      app.UseExceptionHandler("/Error");
      app.UseHsts();
  }
  
  app.UseHttpsRedirection();
  app.UseBlazorFrameworkFiles();
  app.UseStaticFiles();
  
  app.UseRouting();
  
  app.MapRazorPages();
  app.MapFallbackToFile("index.html");
  
  app.Run();
  

4. 配置服务项目的API基础设置 #

• 在服务项目的Program.cs中配置API路由、CORS、认证授权等：

  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddControllers();
  builder.Services.AddEndpointsApiExplorer();
  builder.Services.AddSwaggerGen();
  
  // 配置CORS，允许Client、移动应用等跨域访问（生产环境建议限制具体域名）
  builder.Services.AddCors(options =>
  {
      options.AddPolicy("AllowAll", policy =>
      {
          policy.AllowAnyOrigin()
                .AllowAnyMethod()
                .AllowAnyHeader();
      });
  });
  
  // 添加数据库上下文、业务服务等依赖注入
  // builder.Services.AddDbContext<YourDbContext>(options => ...);
  
  var app = builder.Build();
  
  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  
  app.UseHttpsRedirection();
  app.UseCors("AllowAll");
  app.UseAuthorization();
  
  app.MapControllers();
  
  app.Run();
  

5. 调整Client项目的API调用地址 #

• 在Client项目的wwwroot/appsettings.json中配置独立服务的API地址：

  {
    "ApiBaseUrl": "https://localhost:5001/api/"
  }
  

• 在Client的服务类中读取该配置，替换原Server项目的API调用地址

6. 测试与验证 #

• 启动独立服务、Server、Client三个项目，验证所有API调用功能正常
• 测试移动应用、外部客户的API集成场景，确保跨域、认证等功能符合预期
• 编写单元测试覆盖服务项目的业务逻辑，保障迁移后的代码稳定性

7. 生产环境优化 #

• 将独立服务项目部署到单独服务器或容器，Server项目部署为静态资源托管服务
• 可配置API网关（如Ocelot）统一管理服务路由，方便后续扩展更多服务
• 调整CORS策略，限制为生产环境允许的域名，提升安全性

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