本文详解 express.js 应用中因 nginx 反向代理配置不当或路由路径与静态文件冲突导致的“域名下 api 返回 404，而 ip+端口可访问”问题，并提供标准化解决方案。
本文详解 express.js 应用中因 nginx 反向代理配置不当或路由路径与静态文件冲突导致的“域名下 api 返回 404，而 ip+端口可访问”问题，并提供标准化解决方案。
在 Express.js 应用部署到生产环境时，常通过 Nginx 作为反向代理，将域名请求（如 https://api.example.com）转发至本地 Node.js 服务（如 http://127.0.0.1:3000）。但若配置不一致，极易出现「IP:端口能正常访问 /api/testlist，而使用域名访问却返回 404」的现象——这并非 Express 代码本身有逻辑错误，而是请求路径在代理链中被意外截断、重写或与静态资源规则冲突所致。
你提到“创建一个空的 testlist 文件后，把路由从 /api/testlist 改为 /testlist 就生效了”，这恰恰暴露了一个典型陷阱：Nginx 配置中可能启用了 try_files 指令，且优先匹配静态文件路径。例如以下常见但危险的配置：
location / {
try_files $uri $uri/ /index.html;
proxy_pass http://localhost:3000;
}
该配置会让 Nginx 在转发前先检查是否存在名为 testlist 的静态文件（或目录）。当你新建空文件 testlist 后，Nginx 认为这是一个合法静态资源，直接返回 200（空内容），而非代理给 Express；而你又恰好把 Express 路由改为 /testlist，反而“巧合”绕过了原有 /api/ 前缀的代理路径不匹配问题——但这属于掩耳盗铃，不可复现且易崩坏。
✅ 正确做法是明确分离 API 与静态资源路径，并在 Nginx 中精准代理：
-
保持 Express 路由语义清晰（推荐保留 /api/ 前缀）：
app.get("/api/testlist", async (req, res) => { /* ... */ }); -
Nginx 配置需显式代理 /api/ 路径，避免 try_files 干扰：
server { listen 80; server_name api.example.com; # 静态资源（如 / 或 /index.html）可由 Express 自行处理或由 Nginx 托管 location / { proxy_pass http://localhost:3000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection 'upgrade'; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } # 关键：所有 /api/ 开头的请求必须强制代理，禁止 try_files 查找静态文件 location ^~ /api/ { proxy_pass http://localhost:3000; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }
⚠️ 注意事项：
location ^~ /api/ 中的 ^~ 表示前缀匹配且优先级高于正则匹配，确保 /api/ 请求绝不落入 location / 的 try_files 逻辑；
移除 try_files 对 API 路径的影响，仅保留在纯静态站点中使用；
Express 中无需为域名做特殊判断——只要 Nginx 正确转发 Host 和路径，req.originalUrl 会自动包含 /api/testlist；
-
MongoDB 连接应使用 await client.connect()（你当前是同步调用 .connect()，未 await，可能导致后续查询时连接未就绪）；建议重构为：
async function startServer() { try { await client.connect(); console.log('Connected to MongoDB'); app.listen(port, () => { console.log(`Server listening on port ${port}`); }); } catch (err) { console.error('Failed to connect or start server:', err); process.exit(1); } } startServer();
总结：域名下 API 404 的根源几乎总是反向代理配置与应用路由约定不一致。不要依赖“新建空文件”这类临时 workaround，而应通过 Nginx 精确路径代理 + Express 规范化路由 + 异步资源初始化 构建健壮部署链。这样既能保障 /api/testlist 语义清晰、可维护，也能让域名与 IP 访问行为完全一致。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
