如何通过.NET Standard结合Web API访问Service Fabric集群

我之前帮不少开发者解决过类似的问题，结合Visual Studio 2017的特性，给你整理一套完全适配的可行方案，避开那些过时或针对.NET Core的教程坑：

一、先搞定基于.NET Standard的无状态服务项目 #

• 打开Visual Studio 2017，新建一个Service Fabric应用程序，选好项目名称和保存路径。
• 在添加服务的步骤里，选择无状态服务模板。如果创建时没看到.NET Standard选项，先创建再说，之后右键服务项目→属性→应用程序，把目标框架改成**.NET Standard 2.0**（Service Fabric SDK对2.0及以上版本支持很稳定）。
• 给服务项目安装两个核心NuGet包：Microsoft.ServiceFabric.Services和Microsoft.ServiceFabric.Services.Remoting，确保版本和你安装的Service Fabric SDK一致，避免版本冲突。

二、定义跨项目的.NET Standard服务接口 #

为了让Web API能安全调用服务，我们需要把服务的操作接口抽成独立的.NET Standard类库：

• 在解决方案里新建一个**.NET Standard类库**项目（目标框架选2.0）。
• 在这个类库中创建服务接口，必须继承IService，示例代码如下：

using Microsoft.ServiceFabric.Services.Remoting;
using System.Threading.Tasks;

namespace MyServiceInterfaces
{
    public interface IMyDataService : IService
    {
        Task<string> GetDataAsync(string key);
        // 这里可以加你需要的其他数据操作方法，比如新增、修改
    }
}

• 回到无状态服务项目，引用这个类库，然后让服务类实现这个接口，同时添加远程调用的Listener：

using Microsoft.ServiceFabric.Services.Remoting.Runtime;
using Microsoft.ServiceFabric.Services.Runtime;
using MyServiceInterfaces;
using System.Threading.Tasks;

namespace MyDataService
{
    public class MyDataService : StatelessService, IMyDataService
    {
        public MyDataService(StatelessServiceContext context) : base(context)
        {
            // 这里可以初始化你的数据来源，比如内存缓存、数据库连接
        }

        public async Task<string> GetDataAsync(string key)
        {
            // 替换成你的实际数据获取逻辑
            return await Task.FromResult($"获取到Key为{key}的数据：示例内容");
        }

        protected override IEnumerable<ServiceInstanceListener> CreateServiceInstanceListeners()
        {
            // 启用Service Fabric远程调用Listener，让外部能通过接口调用服务
            return this.CreateServiceRemotingInstanceListeners();
        }
    }
}

三、构建基于.NET Framework的Web API（依赖.NET Standard接口） #

注意：.NET Standard是规范，不能直接跑Web API，所以我们用ASP.NET Web API（基于.NET Framework）来做对外暴露的接口层，它可以完美引用.NET Standard类库，符合你的“基于.NET Standard而非.NET Core”的要求：

• 在解决方案里新建**ASP.NET Web Application (.NET Framework)**项目，选择“Web API”模板，目标框架选.NET Framework 4.7.2及以上（能很好兼容.NET Standard 2.0）。
• 给Web API项目安装NuGet包Microsoft.ServiceFabric.Services.Remoting.Client，同时引用之前创建的.NET Standard接口类库。
• 在Web API项目里新建一个控制器，实现对Service Fabric服务的调用：

using System.Web.Http;
using Microsoft.ServiceFabric.Services.Remoting.Client;
using MyServiceInterfaces;

namespace MyWebApi.Controllers
{
    public class DataController : ApiController
    {
        [HttpGet]
        public async Task<IHttpActionResult> Get(string key)
        {
            // 这里的Uri要和你Service Fabric应用里的服务名称一致，格式是fabric:/应用名/服务名
            var serviceUri = new Uri("fabric:/MyFabricApp/MyDataService");
            // 创建服务代理，通过接口调用服务方法
            var serviceProxy = ServiceProxy.Create<IMyDataService>(serviceUri);
            
            var result = await serviceProxy.GetDataAsync(key);
            return Ok(result);
        }
    }
}

四、部署与测试 #

• 先把你的Service Fabric无状态服务部署到Azure集群（或本地开发集群），确保只有1个实例在运行。
• 部署Web API项目：可以部署到本地IIS，或者Azure App Service。如果是部署到Azure，要确保Web API所在的资源和Service Fabric集群在同一个虚拟网络，或者集群开放了远程通信的端口（默认是19000、19080）。
• 测试接口：比如访问http://你的WebAPI地址/api/data?key=test，应该能拿到服务返回的数据。

几个避坑提醒 #

• 一定要保证所有Service Fabric相关的NuGet包版本完全一致，不然很容易出现奇怪的运行时错误。
• Visual Studio 2017要安装最新的Service Fabric工具：打开Visual Studio Installer→单个组件→找到“Azure Service Fabric工具”安装或更新。
• 如果Web API在集群外部，不想直接开放集群端口，可以用Service Fabric的反向代理来转发请求，这样更安全。

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