YARP无需手动创建代理实例，核心依赖AddReverseProxy()注册与MapReverseProxy()挂载；MapReverseProxy()失效主因是中间件顺序错误，须置于UseRouting()等之后、app.Run()之前，且自定义中间件需显式包裹于其回调中。
YARP 不需要“创建代理实例”这种手动初始化操作，它靠 AddReverseProxy() 和 MapReverseProxy() 两个调用就完成核心注册与挂载 —— 真正要花精力的是配置结构是否合法、路由是否能命中、集群地址是否可连。
为什么 MapReverseProxy() 没生效？
最常见原因是中间件顺序错误。YARP 的 MapReverseProxy() 必须在所有影响请求路径或终止响应的中间件之后、但在 app.Run() 之前调用。
-
app.UseHttpsRedirection()、app.UseRouting()、app.UseAuthorization()这些可以保留，但不能放在MapReverseProxy()后面 - 如果你加了自定义中间件（比如鉴权或日志），又希望它对代理流量生效，必须显式包裹在
MapReverseProxy()的回调里：app.MapReverseProxy(proxyApp => proxyApp.UseMiddleware<myauthmiddleware>());</myauthmiddleware> - 如果用了
WebApplication.CreateSlimBuilder()，默认不带UseRouting()，必须手动加，否则路由匹配直接失败
LoadFromConfig() 加载不到配置怎么办？
YARP 默认只读取 Configuration.GetSection("ReverseProxy")，不是整个 appsettings.json。配置节名大小写敏感，且必须是顶层节点。
- 检查 JSON 是否有语法错误（尤其末尾多逗号、引号不闭合），YARP 不报错，只会静默跳过整个节
- 确认配置文件已设为“复制到输出目录”，.NET 6+ 默认
appsettings.Development.json不会自动加载，需手动builder.Configuration.AddJsonFile("appsettings.Development.json", optional: true) - 若用环境变量覆盖配置（如
ReverseProxy__Routes__route1__ClusterId=cluster1），双下划线__是分隔符，不能写成_或. - 修改 JSON 后无需重启进程，但首次启动时若配置无效，
MapReverseProxy()会注册空路由表 —— 表现为 404，且日志里无任何 YARP 路由匹配记录
路由匹配不到，Path 和 Hosts 怎么写才对？
Path 是 ASP.NET Core 风格的路由模板，Hosts 是字符串数组，二者是 AND 关系：必须同时满足才算匹配成功。
-
"Path": "{**catch-all}"表示捕获全部路径，但注意它不会匹配根路径/以外的空路径；若需匹配/，加一条"Path": "/"或改用"{**catchall}"（少个短横） -
"Hosts": ["api.example.com"]匹配 Host 请求头，不校验证书域名或 DNS 解析结果；若测试用 localhost，得写"localhost"或"localhost:5000"，不能省略端口（当实际请求带端口时） - 多个路由共存时，YARP 按配置中出现顺序尝试匹配，第一个完全匹配的生效 —— 所以更具体的路由（如
/users/{id}）应放在通配路由（如{**catch-all}）前面
集群地址返回 502，Address 字段要注意什么？
Address 值必须是完整 URL（含协议），且目标服务必须允许跨域或已配置 CORS，否则浏览器请求会卡在预检（OPTIONS）阶段。
- 不要写
"Address": "http://service1"—— Docker 内网 DNS 可能解析失败；优先用"http://service1:8080/"或明确 IP - HTTPS 后端需确保证书可信，或在集群配置中禁用验证：
"HttpClient": { "SslProtocols": "None" }（仅限开发） - YARP 默认复用连接池，若后端服务重启，旧连接可能残留导致短暂 502；可通过
"HealthCheck": { "Active": { "Interval": "00:00:10" } }启用主动健康检查 - 地址末尾斜杠
/影响路径拼接：若路由Path是/api/{**catchall}，而Address是https://backend/，则最终请求是https://backend/api/xxx；若Address是https://backend（无尾斜杠），则变成https://backendapi/xxx—— 直接 404
真正难调的不是写配置，而是确认请求到底进了哪条路由、被转发到了哪个地址、中间有没有被其他中间件截断或改写 —— 开启 Microsoft.AspNetCore.Hosting 和 Yarp.ReverseProxy 两个命名空间的日志级别为 Debug，比查文档快十倍。
