把 .htaccess 转成 Nginx 规则，为什么转换完就失效了？

1两边最容易踩的三处差异

理解这三条，大部分迁移事故都能解释。

只改写一个配置项就可能导致整站规则失效：目录级配置默认不被允许读取，必须显式开启，否则文件里的规则一条都不会执行。

2前缀剥离到底怎么影响正则

用一个具体路径走一遍就清楚了。

请求路径会被切掉一段

假设规则放在某个子目录下，请求进来的完整路径是子目录名加文件名，切掉子目录前缀后只剩文件名。

于是开头的斜杠消失了

被匹配的字符串不以斜杠开头，所以任何以斜杠打头的正则在这个上下文里都不可能命中。

想拿完整路径得换变量

需要跟完整路径比时，不能直接用规则模式，要改用保存完整请求路径的那类条件变量。

相对替换的前缀另有开关

替换结果前面要不要加回目录前缀，由专门的基路径指令决定，不能想当然。

排查手法很朴素：先在这条规则旁边临时打印一下实际参与匹配的字符串，看清楚它长什么样，再决定正则怎么写。这比反复猜快得多。

3语义与标志的对应关系

语法像，行为不完全像。

两边的重写模型也不一样：一边是状态机式流水线，改写后可以继续流向后续规则甚至重头再来；另一边是按位置匹配后依次执行。复杂规则嵌套时，这种差异会放大。

4迁移时的可靠顺序

按这个顺序做，返工最少。

先把「是否生效」确认清楚

在新环境里放一条最简单的测试规则，确认配置确实被加载了，再谈规则对不对。

逐条改写，不要整段粘贴

一条规则改一条、测一条。整段粘贴之后出问题，排查成本会成倍上升。

把「匹配对象」写进注释

在每条规则旁注明它期望匹配的是带前缀还是不带前缀的路径，日后维护时不会误改。

上线前用旧链接回归

把站点里外链最多的那些地址列出来逐个访问，确认没有出现跳转循环或者状态码错乱。