迁移 Apache 配置到 Nginx 时，rewrite 规则转换的核心是将 Apache 的 RewriteRule 和 RewriteCond 语法映射为 Nginx 的 rewrite 指令或 try_files 逻辑。自动化工具可辅助转换，但必须人工验证正则表达式和 flags 标记，特别是涉及查询参数和目录判断的场景。

命令速用版

可使用开源命令行工具或在线转换器生成基础配置，减少手工重写工作量。

使用命令行工具 apache2nginx 转换配置文件：
apache2nginx -f /etc/httpd/conf/httpd.conf

或使用在线转换工具处理.htaccess 规则：

访问 http://www.anilcetin.com/convert-apache-htaccess-to-nginx/ 上传或粘贴规则

为什么会这样

Apache 和 Nginx 的处理机制不同，导致规则无法直接通用。Apache 支持目录级的.htaccess 文件，每个目录可独立配置重写规则；Nginx 配置集中在主配置文件，通过 location 块匹配请求路径。此外，Apache 的正则表达式语法与 Nginx 存在差异，例如查询参数问号的处理和路径斜杠的匹配规则不同，直接迁移会导致 404 错误或死循环。

分步处理

按照以下步骤手动修正自动转换后的配置，确保规则逻辑准确。

1. 备份与解析
备份原始 Apache 配置文件，识别其中的 RewriteEngine、RewriteCond 和 RewriteRule 指令。确认是否启用了 mod_rewrite 模块。

2. 指令语法转换
将 Apache 的 RewriteRule 替换为 Nginx 的 rewrite 指令。去掉 Apache 规则中目标 URL 前的反斜杠转义，例如将 list\.php 改为 list.php。每条规则末尾添加 flag 标记，如 last 或 permanent。

3. 条件逻辑映射
Apache 的 RewriteCond 用于判断文件或目录是否存在。在 Nginx 中，简单场景推荐使用 try_files 指令替代复杂的 if 判断。例如将 !-f 和 !-d 条件转换为 try_files $uri $uri/ /index.php?$args。

4. 标记 Flags 映射
对照转换 flags 标记。Apache 的 [L] 标记对应 Nginx 的 last；[R=301] 对应 permanent；[R=302] 对应 redirect。禁止访问标记 [F] 需在 location 块中使用 return 403 实现。

5. 虚拟主机配置
将转换后的规则放入 server 块的 location 段落中。确保 server_name 和 root 路径与原 Apache 虚拟主机配置一致。

怎么验证是否生效

配置完成后，必须通过语法检查和实际访问测试确认规则生效。

1. 语法检查
执行 nginx -t 命令检查配置文件语法是否正确，确保无报错信息。

2. 状态码测试
使用 curl -I 命令检查特定 URL 的返回状态码。例如验证重定向规则是否返回 301 或 302，禁止访问规则是否返回 403。

3. 业务逻辑验证
访问网站前台关键页面，确认伪静态 URL 能正确解析到对应的 PHP 或静态文件，检查页面内容是否加载正常。

常见坑

迁移过程中容易忽略细节，导致规则失效或服务器错误。

• 查询参数丢失：Apache 规则中有时隐含传递查询参数，Nginx rewrite 指令需显式添加$args 或$is_args 变量，否则参数可能丢失。
• 斜杠匹配差异：Apache 规则中路径开头有时不需要斜杠，而 Nginx 的 location 匹配通常需要从根路径开始，需注意正则表达式中的^符号使用。
• 条件判断复杂性：复杂的 RewriteCond 组合逻辑在 Nginx 中难以用单一 if 实现，建议拆分为多个 location 块或使用 try_files 简化。
• 性能影响：Nginx 中滥用 if 指令可能影响性能，优先使用 try_files 或 location 正则匹配来处理重写逻辑。

常见问题

自动转换工具生成的配置可以直接使用吗？

不建议直接使用，自动工具生成的配置仅适合作为参考初稿。工具难以处理复杂的业务逻辑和特定的正则表达式，必须人工审查并测试。

Nginx 是否支持.htaccess 文件？

Nginx 原生不支持.htaccess 文件，必须将规则迁移到主配置文件 nginx.conf 或包含的子配置文件中。

Apache 的 [L] 标记在 Nginx 中对应什么？

Apache 的 [L] 标记表示最后一条规则，在 Nginx 中对应 last 标记，表示当前规则匹配成功后停止后续重写处理。

如何处理 Apache 中的 RewriteCond 文件存在性判断？

在 Nginx 中推荐使用 try_files 指令处理文件存在性判断，例如 try_files $uri $uri/ /index.php;$args，比使用 if 判断更高效且安全。

参考来源

• 百度开发者中心：Apache 到 Nginx 配置迁移工具设计与实现
• GitHub：apache2nginx 源代码及文档 (https://github.com/nhnc-nginx/apache2nginx)
• Anil Cetin：在线 Apache 转 Nginx 转换工具 (http://www.anilcetin.com/convert-apache-htaccess-to-nginx/)
• CSDN 博客：Apache 到 Nginx 重写规则转换
• 51CTO 博客：Apache Rewrite 伪静态规则转换为 Nginx Rewrite