Consul配置加载需手动配置ConsulClient、指定带/的prefix、启用ReloadOnChange并处理ACL；Nacos推荐DotNetCore.NacosConfig，严格要求NamespaceId、DataId、Group全填且匹配控制台，ConfigType影响层级解析。
Consul 配置加载要用 Microsoft.Extensions.Configuration.Consul 包
直接用 IConfigurationBuilder.AddConsul() 是最常见的做法，但必须注意：它默认只拉取 KV 中的扁平键值，不支持自动层级映射（比如 app:db:conn 不会自动变成 app.db.conn）。需要手动指定 prefix 和 optional 参数。
常见错误是漏掉 ConsulClient 实例配置，导致连接超时却报 NullReferenceException。实际要先注册 ConsulClient 到 DI 容器，或传入自定义实例：
builder.Configuration.AddConsul("app/", options =>
{
options.ConsulClient = new ConsulClient(cfg => cfg.Address = new Uri("http://localhost:8500"));
options.Optional = false;
options.ReloadOnChange = true;
});
- 路径末尾加
/（如"app/"）才能正确递归读取子路径 -
ReloadOnChange = true依赖 Consul 的 blocking query，需确保服务端支持且网络稳定 - 若 Consul 启用了 ACL，必须在
ConsulClient中设置Token
Nacos 配置加载优先选 DotNetCore.NacosConfig
Microsoft.Extensions.Configuration.Nacos 社区维护弱、版本滞后，推荐用 DotNetCore.NacosConfig（v2.x 起已适配 .NET 6+）。它把 DataId、Group、NamespaceId 全部作为必填参数，缺一不可——很多人卡在 namespaceId 为空导致连上却读不到配置。
典型初始化方式：
builder.Configuration.AddNacos(c =>
{
c.ServerAddresses = new[] { new Uri("http://localhost:8848") };
c.NamespaceId = "public"; // 注意：不是空字符串，也不是 null
c.DataId = "appsettings.json";
c.Group = "DEFAULT_GROUP";
c.ConfigType = ConfigType.Json;
});
-
DataId必须和 Nacos 控制台中“配置管理”里的 Data ID 完全一致（含后缀） - 如果用了自定义命名空间，
NamespaceId要填控制台里显示的 ID 字符串，不是名称 -
ConfigType = ConfigType.Json才能自动解析为 IConfiguration 层级结构；用Properties类型则只能 flat key
配置热更新在 Consul/Nacos 中行为不同
Consul 的 ReloadOnChange 本质是轮询 + blocking query，延迟通常 1–5 秒；Nacos 的监听是长轮询，响应更快（约 300ms），但要求客户端保持 HTTP 连接畅通。
- Consul 下修改配置后，
IOptionsMonitor<T>能立刻收到变更，但IConfiguration的原始键值不会刷新——得靠GetSection().Get<T>()重新解析 - Nacos 默认启用监听，但若服务端重启或网络闪断，客户端可能丢失监听，需检查日志中是否有
"Listening cancelled" - 两者都不支持运行时动态切换 DataId 或 KV prefix——改了就得重启应用或手动重建
IConfiguration
环境隔离别只靠前缀，要结合 Namespace/Group
仅用 "dev/app/" 这类前缀做环境区分，在多团队共用 Consul 集群时容易冲突；Nacos 更应优先用 NamespaceId 隔离，而不是拼接环境名到 DataId。
- Consul 推荐按团队或业务域划分 KV 根路径（如
team-a/prod/），再配合 ACL 控制读写权限 - Nacos 中
NamespaceId是硬隔离，同一个DataId在不同 namespace 下互不影响，这才是生产环境该用的方式 - 别在代码里写死环境名，应从启动参数或环境变量读取
NACOS_NAMESPACE_ID或CONSUL_PREFIX
