Elastic Beanstalk弃用Apache后如何正确配置NGINX替代.htaccess实现URL重写

核心本质错误 #

你当前的部署文件路径完全不符合Elastic Beanstalk的配置加载规则，这是配置不生效的最主要原因：

• Elastic Beanstalk 不会自动读取.ebextensions/nginx/conf.d/路径下放置的.conf配置文件。这类文件只会被当作普通项目静态资源，最终被拷贝到应用的web资源根目录，根本不会被Nginx进程纳入配置加载范围。很多开发者误以为平台会自动同步该路径下的配置到系统Nginx目录，实际这类自动同步逻辑仅在极个别特殊语言运行时的平台版本中启用，绝大多数PHP运行时的EB环境都不会加载这个路径下的文件。

正确的配置实现方案 #

要实现等效于.htaccess的URL重写能力，必须通过ebextensions的内置指令，主动将自定义配置部署到Nginx默认的配置读取路径，操作方式如下：

1. 在项目根目录的.ebextensions文件夹下，新建后缀为.config的配置文件（需放在.ebextensions目录根层级，不能嵌套子目录），例如命名为url-rewrite.config。
2. 在该配置文件中写入如下内容，通过文件部署指令将重写规则写入实例系统的Nginx配置目录，再通过部署后指令重启Nginx让配置生效：

# 将自定义重写规则部署到Nginx默认加载的配置路径
files:
  "/etc/nginx/conf.d/custom-rewrite.conf":
    content: |
      location / {
          try_files $uri $uri/ /test.php?$args;
      }

# 部署流程收尾阶段重启Nginx，加载新写入的配置
container_commands:
  reload_nginx_config:
    command: "systemctl restart nginx"

注：Nginx本身不支持Apache式的分布式.htaccess配置，所有路由、重写规则都必须在Nginx的全局配置块中定义，不存在可以直接替代.htaccess的分布式文件机制。

其他常见失效原因排查 #

• 部署包完整性校验：.ebextensions是带点开头的隐藏目录，本地打包部署包时，macOS访达、部分默认打包工具会自动排除这类隐藏目录，需要确认最终上传的部署压缩包中确实包含完整的.ebextensions目录及配置文件，避免配置文件仅存在于本地项目、未被打包上传的情况。
• 运行时类型校验：确认当前环境实际运行的Web服务是Nginx而非残留的Apache进程。如果环境切换后没有完全卸载Apache，或平台版本没有正确切换到Nginx运行时，自定义的Nginx配置自然不会被加载。可以通过实例系统进程、平台启动日志确认实际运行的Web服务类型。
• 配置冲突排查：EB默认的Nginx主配置已经预先定义了根路径的location /规则，如果你写入的自定义location块和默认规则的匹配范围重叠，会触发Nginx配置语法校验失败，最终Nginx会自动回退到默认配置运行，表现为自定义规则完全不生效。可以通过SSH登录实例执行nginx -t命令检查配置语法错误，修正冲突的规则定义。

内容的提问来源于stack exchange，提问作者Markk