ExpressJS代理无法匹配/?access开头URL，请求排查配置问题

问题根源 #

Express的路由匹配仅针对URL路径部分（即?之前的内容），不包含查询字符串。你写的app.use('/?access', proxy)实际上是在匹配路径为/?access的请求，但实际请求的路径是/，access=...属于查询参数，所以这个路由规则根本不会触发，请求会被之前的app.get('/')或静态文件中间件处理，导致304缓存响应。

解决方案 #

以下两种方法可实现“所有包含access查询参数的请求转发到8989端口”的需求：

方法1：自定义中间件判断查询参数 #

添加一个中间件，检查请求的查询参数中是否存在access，存在则交由代理处理，否则继续后续路由：

const express = require('express');
const { createProxyMiddleware } = require('http-proxy-middleware');
const path = require('path');

const app = express();
const PORT = process.env.PORT || 8080;
const API_URL = "http://localhost:8989";

app.get("/status", (req, res, next) => {
    res.send('This is a proxy service');
});

app.get('/', function(req, res) {
    res.sendFile(path.join(__dirname, '/dist/index.html'));
});
app.use(express.static('dist'))

const proxyOptions = {
    target: API_URL,
    changeOrigin: true,
    // 确保查询参数完整转发
    preserveQueryParams: true
}

const proxy = createProxyMiddleware(proxyOptions);

// 自定义中间件判断查询参数
app.use((req, res, next) => {
    if (req.query.access) {
        return proxy(req, res, next);
    }
    next();
});

app.listen(PORT, () => {
    console.log(`Proxy Started at http://localhost:${PORT}`)
});

方法2：使用http-proxy-middleware的自定义匹配规则 #

直接在代理配置中通过match函数匹配包含access查询参数的请求：

const express = require('express');
const { createProxyMiddleware } = require('http-proxy-middleware');
const path = require('path');

const app = express();
const PORT = process.env.PORT || 8080;
const API_URL = "http://localhost:8989";

app.get("/status", (req, res, next) => {
    res.send('This is a proxy service');
});

app.get('/', function(req, res) {
    res.sendFile(path.join(__dirname, '/dist/index.html'));
});
app.use(express.static('dist'))

const proxy = createProxyMiddleware({
    target: API_URL,
    changeOrigin: true,
    preserveQueryParams: true,
    // 自定义匹配规则：查询参数含access时触发代理
    match: (req) => !!req.query.access
});

app.use(proxy);

app.listen(PORT, () => {
    console.log(`Proxy Started at http://localhost:${PORT}`)
});

关键配置说明 #

• preserveQueryParams: true：确保原请求的所有查询参数（如access、action）被完整转发到目标服务器。
• 两种方法均绕过了Express路由不处理查询字符串的限制，通过直接判断查询参数触发代理逻辑。

测试时建议先清除浏览器缓存（避免304响应干扰），再发送请求或点击链接，此时带access参数的请求会被正确转发到8989端口。

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