部署Node.js/Express.js至AWS Elastic Beanstalk时自定义Nginx配置文件缺失问题排查

首先，咱们来梳理下你遇到的问题核心：在Amazon Linux 2的Elastic Beanstalk环境中，自定义Nginx配置没生效，主要是路径、文件格式以及配置逻辑的几个错误导致的，咱们一步步拆解：

为什么之前的配置没生效？ #

1. .platform路径与文件后缀错误 #

• 你最初把配置放在.platform/nginx/conf.d/elasticbeanstalk/mynginx.conf，但这个elasticbeanstalk子目录是Beanstalk自身存放配置的地方，自定义文件不应该放在这里，Beanstalk不会读取这个目录下的用户自定义配置。
• 后来你改成.platform/nginx/conf.d/mynginx.config，这里的后缀错了！Nginx默认只会加载.conf后缀的配置文件，.config后缀的文件会被直接忽略。

2. .ebextensions的files配置会被覆盖 #

在Amazon Linux 2的Beanstalk环境中，Elastic Beanstalk会管理Nginx的整个配置生命周期，部署过程中会重新生成/etc/nginx下的配置文件，你通过00-files.config直接创建的/etc/nginx/conf.d/mynginx.conf会被Beanstalk的默认配置覆盖，所以不会生效。

正确的解决步骤 #

步骤1：创建正确的.platform配置结构 #

在项目根目录下创建如下目录结构：

.project_root/
└── .platform/
    └── nginx/
        └── conf.d/
            └── mynginx.conf

步骤2：编写正确的Nginx配置内容 #

打开mynginx.conf，注意不要写完整的server块（因为Beanstalk已经有自己的server配置块，重复写会导致Nginx配置冲突启动失败），直接添加需要的指令即可：

client_max_body_size 512M;

步骤3：清理无效的.ebextensions配置 #

删除.ebextensions里的00-files.config，因为咱们现在用.platform的方式更可靠，不会被覆盖。

步骤4：重新打包并部署 #

• 打包项目时，确保.platform、.ebextensions、package.json等所有文件都在ZIP的根目录（不要把整个项目文件夹作为ZIP的根，否则Beanstalk识别不到配置）。
• 通过AWS控制台重新上传ZIP包部署环境。

验证配置是否生效 #

部署完成后，你可以登录EC2实例验证：

1. 执行sudo nginx -t，确认Nginx配置没有语法错误。
2. 查看Nginx的有效配置，执行sudo nginx -T | grep client_max_body_size，应该能看到输出client_max_body_size 512M;。

这样就能确保你的自定义Nginx配置成功生效了。

内容的提问来源于stack exchange，提问作者Wai Yan Hein