1. 为什么.Net微服务一定要有网关:单体拆分后的三个失控时刻
先说一个我自己的经历。当时我们把一个老旧的ASP.NET Core单体系统拆成了十几个微服务,服务之间通过HTTP调用,每个服务都直接暴露自己的IP和端口。一开始觉得"这不挺好吗,服务都起来了,调用也能通",直到有一天做了一次线上缩容。
运维把两个实例下线了,结果客户端那边立刻报错——有个老客户端还在轮询那个已经被回收的IP。那一刻我才意识到一个事儿:服务拆分得越细,服务实例的IP和端口就越像流动的水,今天这个在,明天那个没了。如果你没有一个统一的"入口"帮你搞清楚"该把请求交给谁",那整个系统就是一堆会随时失联的裸服务。这就是网关存在的核心意义。
再说第二个失控时刻:认证和鉴权。单体时代,登录态在进程内就能校验;微服务化之后,每个服务都做一遍登录校验?十几个服务,每个都要接一遍Token解析逻辑?我见过最夸张的团队,一个服务自己搞了一套鉴权,另一个服务压根没做,全部裸奔。网关在此时的价值,就是把"跨服务通用的横切逻辑"收口到一层集中处理,下游服务只关注业务本身。
第三个失控时刻是流量治理。微服务之间是网状调用的,假设十几个服务互相调用,任何一个节点抖动,都可能像连锁反应一样把整个调用链拖垮,这就是所谓的"雪崩效应"。没有网关统一做熔断、限流、超时控制,你根本没法在入口处把所有流量管住。
所以,.Net微服务架构一旦走到一定规模,网关就不是"要不要"的问题,而是"怎么选型、怎么落地"的问题。而在我做过的方案里,采用 Consul做服务注册与发现 + Nginx做流量网关 的组合,是我认为在.Net生态里性价比最高、也最容易落地的一套路子。接下来我把这套方案的完整思路、实操步骤和踩过的坑都写出来。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Consul注册中心落地:服务上线后如何让网关"看见"
网关注册和管理这件事,第一步永远是服务注册与发现。简单理解就是:服务启动时主动跟注册中心报到,说"我上线了,IP是xxx,端口是xxx,健康检查地址是xxx";服务下线时也要主动注销,或者被注册中心通过健康检查"发现"已经不健康,然后踢出去。
2.1 为什么选Consul,而不是ZooKeeper或Etcd
.Net生态里做服务注册中心,常见的选项有Consul、Etcd、ZooKeeper,还有Nacos。我最终选择Consul,主要是三个原因:
- 健康检查机制完善。Consul原生态支持HTTP、TCP、gRPC三种健康检查方式,对.Net服务非常友好。你只需要提供一个健康检查端点,Consul会定时来探活,发现你挂了就自动把服务标记为不健康,并触发服务发现时的过滤。这个能力在ZooKeeper里基本没有,ZK的临时节点机制虽然也能感知掉线,但它是靠会话保活来判断的,网络分区时容易误判。
- 服务发现支持DNS和HTTP API两种方式。HTTP API对网关侧做动态感知非常灵活,DNS方式则能让一些老系统用域名直接访问内部服务,兼容性更好。
- 运维成本低。Consul是Go写的,单二进制文件就能跑,不像ZK要维护Java环境。三个节点就能组成一个高可用集群,对中小团队来说完全够用。
Etcd其实也不错,但它的定位更偏分布式键值存储,健康检查、服务目录这些功能需要自己开发一层封装,落地成本比Consul高。Nacos在.NET生态的SDK支持也一般,所以我还是选择了Consul。
2.2 .Net服务注册到Consul的两种方式
先说一下,.NET服务向Consul注册有两种常见路径。
第一种是使用Consul官方SDK(Consul包,NuGet上的Consul库)。在服务启动时调用SDK的Agent Service Register接口完成注册。核心逻辑如下:
csharp复制public static void RegisterService(this IApplicationBuilder app, IConfiguration config)
{
var consulClient = new ConsulClient(c =>
{
c.Address = new Uri(config["Consul:Address"]);
});
var registration = new AgentServiceRegistration
{
ID = $"{config["Service:Name"]}-{config["Service:IP"]}-{config["Service:Port"]}",
Name = config["Service:Name"],
Address = config["Service:IP"],
Port = int.Parse(config["Service:Port"]),
Tags = new[] { config["Service:Version"], "v1" },
Check = new AgentServiceCheck
{
HTTP = $"http://{config["Service:IP"]}:{config["Service:Port"]}/health",
Interval = TimeSpan.FromSeconds(10),
Timeout = TimeSpan.FromSeconds(5),
DeregisterCriticalServiceAfter = TimeSpan.FromSeconds(30)
}
};
consulClient.Agent.ServiceRegister(registration).GetAwaiter().GetResult();
}
这里的几个关键配置值得展开讲一下:
- Check.HTTP 指向的是服务自己的健康检查端点,这个端点必须真实存在且快速返回200。我见过很多人把健康检查端点指向了首页或某个业务接口,结果业务接口稍微慢一点,Consul就误判服务不健康,直接把你从负载池里摘掉了。所以健康检查端点最好是独立的、轻量的,只做进程存活和依赖状态的最简校验。
- Interval 是Consul探活的频率。设置10秒比较合理,太频繁会给服务造成不必要的压力,太慢又会导致故障感知不及时。
- DeregisterCriticalServiceAfter 这个参数极易被忽略。它的含义是:如果服务处于"严重不健康"状态超过30秒,Consul会直接把这个服务实例从注册中心移除,而不是一直保留在一个"不健康"状态。这个配置对网关侧很关键,因为Nginx同步服务列表时一般只拉"通过健康检查"的服务,如果实例一直处于不健康状态挂在目录里,某些同步方案会把状态搞得很混乱。
第二种方式是服务启动时自己调用Consul的HTTP API,本质上跟SDK一样,只不过不用引第三方包。就是向/v1/agent/service/register发一个PUT请求,Body是JSON格式的注册信息:
json复制{
"ID": "order-service-192.168.1.10-8080",
"Name": "order-service",
"Tags": ["v1"],
"Address": "192.168.1.10",
"Port": 8080,
"Check": {
"HTTP": "http://192.168.1.10:8080/health",
"Interval": "10s",
"Timeout": "5s",
"DeregisterCriticalServiceAfter": "30s"
}
}
这两种方式没有本质区别,我建议在.NET项目里直接用SDK,省事且类型安全。如果是非.NET语言写的服务(比如边缘的Python脚本服务),直接用HTTP API接入就行。
2.3 服务注销:优雅下线比注册更重要
注册的上半场是注册,下半场是注销。很多人只写了注册逻辑,忘记在服务停止时注销,导致Consul里堆了一堆幽灵实例。
正确的做法是在进程退出前调用Agent.ServiceDeregister,把当前实例的ID传进去:
csharp复制public static void DeregisterService(this IApplicationBuilder app, IConfiguration config)
{
var consulClient = new ConsulClient(c =>
{
c.Address = new Uri(config["Consul:Address"]);
});
var serviceId = $"{config["Service:Name"]}-{config["Service:IP"]}-{config["Service:Port"]}";
consulClient.Agent.ServiceDeregister(serviceId).GetAwaiter().GetResult();
}
在ASP.NET Core中,可以注册到`IApplicationLifetime.ApplicationStopp
