使用TypeScript开发Node.js项目时localhost访问无响应如何解决？

根因定位 #

请求无响应的核心原因是模块导入导出规范不匹配，导致HTTP服务拿到的不是正常的Express请求处理函数，请求进入后无法被处理，一直处于挂起状态：

• app.ts 采用CommonJS规范的module.exports = app导出Express实例
• server.ts 采用ES模块规范的import * as app from "./app"导入，此时拿到的app是模块命名空间对象，不是实际的Express实例，传入createServer后无法处理请求

修复步骤 #

1. 统一模块规范（二选一即可） #

方案A：统一使用ES模块规范

修改app.ts导出语句：
将原来的module.exports = app替换为：

export default app;

修改server.ts导入语句：
将原来的import * as app from "./app"替换为：

import app from "./app";

如果使用该方案，建议同步修改meals.ts的导出语句为export default router，保持项目规范统一。

方案B：统一使用CommonJS规范

修改server.ts导入语句，替换为：

const app = require("./app");

2. 补充端口监听校验和日志 #

当前监听代码没有回调日志，无法确认服务是否启动成功，也没有端口 fallback 逻辑，若.env未配置PORT会启动失败：
修改server.ts的监听代码：

dotenv.config();

// 新增端口兜底逻辑
const PORT = process.env.PORT || 3000;
const server = createServer(app);

// 新增启动成功日志
server.listen(PORT, () => {
  console.log(`服务启动成功，访问地址：http://localhost:${PORT}`);
});

同时确认项目根目录存在.env文件，若需要自定义端口可在文件内配置PORT=你要的端口号。

访问注意事项 #

项目当前只配置了/meals路由，启动成功后需要访问http://localhost:你的端口/meals才能拿到响应，直接访问根路径/默认返回404，属于正常现象。

可选优化建议 #

1. 新增全局404处理中间件，在app.ts路由配置之后添加：

app.use((req: Request, res: Response) => {
  res.status(404).json({
    message: "请求的接口不存在"
  });
});

2. 新增全局错误处理中间件，捕获运行时异常：

app.use((err: Error, req: Request, res: Response, next: NextFunction) => {
  console.error(err.stack);
  res.status(500).json({
    message: "服务内部错误"
  });
});

3. 检查tsconfig.json中的module配置项设置为CommonJS，适配Node.js运行环境，避免编译后的代码出现模块导入问题。

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