Nginx中rewrite不继承，仅在声明处生效；应置于具体location内而非server顶层，避免干扰URI匹配；可用try_files+named location实现安全复用。
避免在 Nginx 基础架构中因误用全局重写破坏路由继承，关键在于理解 rewrite 不是“配置继承”机制的一部分，而是运行时的路径转换动作——它发生在请求匹配完成之后、代理或文件服务之前，且不向下传递语义。所谓“实例路由无法被正常继承”，本质是把 rewrite 当成了作用域配置来复用，而它根本不会被子 location 继承或叠加。
rewrite 指令不具备继承性，只在声明处即时生效
rewrite 属于 Action 类指令：一旦在某一层级（如 server 或 location）中定义，就只对该层级内匹配到的请求起作用；它不会自动出现在子块中，也不能靠“继承”让下级 location 复用上层的重写逻辑。
- server 块里写 rewrite ^/old/(.*)$ /new/$1 break; → 只对未进入更细粒度 location 的请求生效
- 若请求命中某个 location /api { … }，则 server 级 rewrite 完全不执行，哪怕该 location 内没写任何 rewrite
- 想让 /api 下的请求也走重写，必须在 location /api { } 内显式再写一遍，不能依赖外层
全局重写易掩盖真实路由意图，导致 location 匹配失效
把 rewrite 放在 http 或 server 顶层，看似“统一处理”，实则干扰了 Nginx 的核心路由机制：location 匹配基于原始 URI，而顶层 rewrite 会提前改写 URI，使后续 location 无法按预期匹配。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 错误示例：
server {
rewrite ^/v1/(.*)$ /v2/$1 break;
location /v2/api { proxy_pass http://svc; }
}
→ 请求 /v1/api 被提前重写为 /v2/api，但此时已脱离 location /v1/ 上下文，可能跳过你真正想控制的 /v1/api 规则 - 正确做法：将 rewrite 放进具体 location 中，确保它与匹配逻辑同层、可控、可追溯
用 try_files + named location 替代“伪全局 rewrite”
若确实需要跨多个 location 共享路径转换逻辑，应避免用顶层 rewrite，转而使用 try_files 配合内部重定向（@named），这是 Nginx 原生支持的、符合上下文机制的协作方式。
- 例如统一处理前端 SPA 的 history fallback：
location / {
try_files $uri $uri/ @rewrites;
}
location @rewrites {
rewrite ^(.*)$ /index.html break;
} - 这样既保持 location 匹配完整性，又实现复用，且不破坏各层级的配置隔离
检查 rewrite 循环与隐式内部重定向风险
rewrite 后若未加 break 或 last，可能触发内部重定向，反复匹配 location，造成“rewrite or internal redirection cycle”错误——这常被误认为是继承断层，实则是执行流程失控。
- break：重写后停止当前 location 内所有 rewrite，继续执行本 location 其余指令（如 proxy_pass）
- last：重写后终止当前 location，重新从头匹配 location（可能再次命中自身，形成循环）
- redirect / permanent：返回 HTTP 跳转，不参与内部流程，安全性高但暴露重写逻辑
