Nacos 注册与网关

Register 提供 Nacos 8848；各服务启动时导入配置并注册自身。Gateway 9999 根据服务名和路由规则转发请求，承担认证透传、跨域、限流、请求头处理和 MCP Key 校验。

路由变更需同时验证服务名、路径前缀、StripPrefix/重写规则、超时、WebSocket/SSE 长连接和健康检查。生产使用 host network 时，Gateway 与服务的端口冲突会直接导致启动失败。

注册和路由的实际链路

服务启动后通过 spring.cloud.nacos.discovery.server-addr 注册 application name、IP、端口和健康状态；配置通过 spring.config.import 读取公共 Data ID 与服务专属 Data ID。Gateway 根据服务名查找健康实例，再按动态路由转发；UPMS 的 SysRouteConf/动态路由初始化会影响最终路由，不能只修改 Gateway 本地文件。

启动服务 -> Nacos 配置导入 -> discovery 注册
         -> Gateway 读取路由/健康实例 -> 请求转发

AI 聊天和轨迹 SSE 需要较长 read timeout、连接保活和 text/event-stream 透传；文件下载不能被响应缓冲或错误改写 Content-Disposition；MCP 路由还要验证服务注册、API Key/Token 和工具授权。

发布路由前先从 Nacos 服务名验证健康实例，再从网关执行登录、AI 流式聊天、文件上传下载和一个 MCP 请求。503 先查服务注册及端口，再查健康状态和 route predicate；连接建立但无 SSE 事件则查网关超时、代理缓冲和下游 channel。