Express+Vite项目本地运行报错，需移除Replit兼容补丁

问题背景 #

项目在Replit上运行正常，但克隆到本地执行npm run dev（命令为rest-express@1.0.0 dev、tsx server/index.ts）时，立即抛出错误：

TypeError: Missing parameter name at 1: https://git.new/pathToRegexpError

报错位置在path-to-regexp/src/index.ts:153:13。

经排查，问题根源：

• Replit自动创建了server/patch-path-to-regexp.ts补丁文件，通过猴子补丁修改v6+版本的path-to-regexp源码
• 项目根目录package.json直接依赖"path-to-regexp": "^6.x"，但Express内部捆绑使用的是express/node_modules中的v0.1.x版本
• Replit的TSX运行器能转译并应用补丁，但本地环境无法识别或覆盖只读属性，导致高版本path-to-regexp解析URL时出错

简洁解决方案 #

1. 清理server/index.ts中的Replit注入代码 #

打开server/index.ts，做两处修改：

import dotenv from "dotenv";
import express from "express";

// 注释或删除这一行：Replit注入的path-to-regexp兼容补丁
// import "./patch-path-to-regexp.js";

dotenv.config();
const app = express();

// 删除以下整个猴子补丁代码块：Replit用于检测"git.new"路由的逻辑
/*
const originalAppUse = app.use.bind(app);
app.use = (...args) => {
  const [maybePath] = args;
  if (typeof maybePath === "string" && maybePath.includes("git.new")) {
    console.error("🔥 Detected bad route registration:", maybePath);
    console.trace();
  }
  return originalAppUse(...args);
};
*/

app.use(express.json());
// … 你的路由定义 …

2. 删除Replit生成的补丁文件 #

直接删除项目中的server/patch-path-to-regexp.ts文件。

3. 卸载根目录的高版本path-to-regexp依赖 #

执行命令，移除项目根目录直接依赖的高版本path-to-regexp：

npm uninstall path-to-regexp

Express内部已经捆绑了所需的v0.1.x版本，无需额外安装。

4. 验证运行 #

• 本地执行npm run dev，确认报错消失，项目正常启动
• 回到Replit环境，重新运行项目，确认功能正常

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