Node.js express.static路由问题：/uploads/images无法正常工作

我部署的Node.js服务器API中，以下路由无法用于获取图片：

app.use("/uploads/images", express.static(path.join("uploads", "images")));

但另一条路由却能正常运行：

app.use("/uploads", express.static('uploads'));

我希望使用第一条路由来更好地对图片进行分类，但不清楚问题出在哪里。以下是我的App.js完整代码：

const fs = require("fs"); //Node Built in file Sytem module
const path = require("path"); //Path Module built in
const mongoose = require("mongoose");

const express = require("express");

const placesRoutes = require("./routes/places-routes");
const usersRoutes = require("./routes/users-routes");
const bodyParse = require("body-parser");

const HttpError = require("./Models/http-error");
const { application } = require("express");
// All the Imports Above

const app = express();

// Using Middleware
app.use(bodyParse.json());

app.use("/uploads", express.static('uploads'));

app.use("/uploads/images", express.static(path.join("uploads", "images")));

//Middleware for Handling CORS Error in Frontend
app.use((req, res, next) => {
  res.setHeader("Access-Control-Allow-Origin", "*");
  res.setHeader(
    "Access-Control-Allow-Headers",
    "Orgin, X-Requested-With, Content-Type, Accept, Authorization"
  );

  res.setHeader("Access-Control-Allow-Methods", "GET,POST,PATCH,DELETE");
  next();
});

// Using Route attaching Middleware
app.use("/api/places", placesRoutes);
app.use("/api/users", usersRoutes);

app.use((req, res, next) => {
  const err = new HttpError("This Route does not exist ", 404);

  throw err;
});
app.use((error, req, res, next) => {
  if (req.file) {
    fs.unlink(req.file.path, (err) => {
      console.log(err);
    });
  }

  if (res.headerSent) {
    return next(error);
  }

  res.status(error.code || 500);
  res.json({ message: error.message || "An unknown error occupied !" });
});

mongoose
  .connect(
    `${process.env.DB_URL}`
  )
  .then(() => {
    console.log("Database Connected");
    app.listen();
  })
  .catch((error) => {
    console.log(error);
  });

问题原因 #

1. 路由顺序冲突：Express中间件按注册顺序匹配请求。你把/uploads的通用路由放在了/uploads/images的精准路由前面，当请求/uploads/images/xxx.jpg时，会先被/uploads路由捕获，直接去uploads目录下查找images/xxx.jpg，导致后面的精准路由永远不会被触发。
2. 相对路径风险：path.join("uploads", "images")使用相对路径，它的解析依赖于启动Node进程的工作目录，而非项目根目录。如果在非项目根目录启动服务器，会导致静态资源路径解析错误。

修复方案 #

1. 调整路由顺序+使用绝对路径 #

把精准路由放在通用路由前面，同时用__dirname拼接绝对路径，确保路径解析准确：

// 先注册精准的图片路由，使用绝对路径
app.use("/uploads/images", express.static(path.join(__dirname, "uploads", "images")));
// 再注册通用的uploads路由
app.use("/uploads", express.static(path.join(__dirname, "uploads")));

__dirname是Node.js的内置变量，代表当前App.js文件所在的目录，用它拼接路径可以避免工作目录变化带来的路径错误。

2. 可选：移除通用路由（如果不需要） #

如果你的静态资源只有图片，且只需要通过/uploads/images访问，直接删除/uploads的静态路由即可，彻底避免路由冲突：

// 只保留图片路由
app.use("/uploads/images", express.static(path.join(__dirname, "uploads", "images")));

验证 #

修复后，请求/uploads/images/test.jpg会被精准路由处理，从项目根目录/uploads/images/下返回对应图片；如果保留通用路由，请求/uploads/other-file.pdf会被/uploads路由处理，返回uploads目录下的其他资源。

内容的提问来源于stack exchange，提问作者Harsh Tripathi - blue