Express应用GET路由在生产环境中无法正常工作

看起来你遇到的核心问题是：本地开发环境中Express的/queryDB路由能正常响应Fetch请求，但部署到NameCheap生产环境后却返回404，尽管DEBUG日志显示路由已经成功创建。结合你的代码和描述，我整理了几个关键的排查点和修复方案：

1. 绝对不要在Express路由中使用完整URL #

你更新后的代码里写了：

app.route("http://url.com/query").all(function(req, res) { ... })

这是错误的用法！Express的路由路径应该是相对服务器根目录的路径，而不是完整的URL。正确的写法应该是：

app.route("/query").all(function(req, res) {
  console.log("Query");
  res.send("Query Res");
});

完整URL会导致Express无法正确匹配请求路径，这是生产环境路由失效的重要原因之一。

2. 修正Fetch请求的路径（避免相对路径陷阱） #

你最初的Fetch用了../queryDB这种相对路径：

const res = await fetch("../queryDB?query=" + query);

这种相对路径的解析依赖于当前页面的URL层级。比如本地开发时，你的页面可能在http://localhost:3000/index.html，../queryDB会解析成http://localhost:3000/queryDB，刚好匹配路由；但如果生产环境中页面的URL结构不同（比如NameCheap部署后页面在子路径下，或者URL后缀不同），相对路径就会解析到错误的地址，导致404。

修复方案：改用绝对路径发起请求，确保无论页面在哪个层级，都能正确指向服务器路由：

// 用根路径开头的绝对路径
const res = await fetch("/queryDB?query=" + query);

如果是更新后的/query路由，就改成fetch("/query")。

3. 检查静态文件服务的优先级冲突 #

Express的中间件是按注册顺序执行的，你的代码里先注册了路由，再注册静态文件服务，这本身没问题，但要注意：如果__dirname目录下存在名为queryDB的文件或文件夹，express.static会优先返回静态资源，而不会触发你的路由。

你可以排查生产环境服务器上的项目目录，确保没有和路由同名的文件/文件夹。另外，NameCheap的Node.js部署可能有特定的静态文件托管规则，有些平台会要求静态文件放在特定目录（比如public），你可以尝试调整静态文件配置：

// 假设静态文件都移到public目录下
app.use(express.static(path.join(__dirname, "public"), { extensions: ["html"] }));
app.use("/css", express.static(path.join(__dirname, "public/css")));
// 其他静态资源路径同理调整

4. 确认NameCheap的端口配置 #

你的代码里设置了app.set("port", process.env.PORT || port);，NameCheap的Node.js环境通常会提供一个环境变量指定端口（比如PORT），确保你没有硬编码端口，而是使用环境变量提供的端口。另外，监听地址保留0.0.0.0更稳妥，允许所有地址访问：

app.listen(app.get("port"), "0.0.0.0", () => console.log("Started listening on %s", app.get("port")) );

5. 用最简路由验证基础功能 #

先部署一个最简版本的服务器，验证路由是否能正常响应：

var express = require("express");
var app = express();
app.set("port", process.env.PORT || 3000);

// 最简测试路由
app.get("/test", (req, res) => {
  res.send("Test route works!");
});

app.listen(app.get("port"), "0.0.0.0", () => console.log("Server running on port", app.get("port")));

然后在浏览器直接访问http://your-url.com/test，如果能返回内容，说明路由基础配置没问题，再逐步添加静态文件服务和数据库查询的逻辑。

恢复数据库查询功能的正确写法 #

如果要回到最初的数据库查询需求，记得把路由改回/queryDB，并确保Fetch用绝对路径，同时给错误响应设置正确的状态码：

var db = require("./db");
app.route("/queryDB").get(function(req, res) {
 console.log(req.query.query);
 db.query(req.query.query, function(err, rows, fields) {
  if (err) res.status(500).send(err); // 明确返回500错误状态码
  else res.send(rows);
 });
});

按照这些步骤排查，应该能解决生产环境的404问题。

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