编写Axios请求TypeScript工具函数后Node启动崩溃，该如何排查问题？

你遇到的启动崩溃问题核心是CommonJS模块规范不支持顶层await：

• Node默认使用CommonJS模块规范，该规范下不允许在模块顶层作用域直接使用await关键字，代码在模块加载阶段就会抛出语法错误，不会执行到实际的业务逻辑，完全符合你描述的现象。
• 次要问题是你业务代码中的变量名AxiosConfig和你全局声明的TS类型别名重名，会引发TS编译冲突，也需要修正。

方案1：使用异步立即执行函数包裹调用逻辑（改造成本最低，无需修改项目配置） #

把业务代码修改为如下格式即可：

import { axiosReq } from "../utils";

// 修改变量名，避免和全局类型AxiosConfig重名
const requestConfig = { 
    url: 'https://172.24.14.12/api/baseline', 
    method: 'POST',
    data: {}
};

// 用异步立即执行函数包裹需要用await的逻辑
(async () => {
  try {
    const res = await axiosReq(requestConfig);
    // 原有的返回值处理逻辑写在这里
  } catch (err) {
    console.error('请求执行异常：', err);
  }
})();

方案2：启用ES Module规范支持顶层await #

如果确实需要使用顶层await，做如下配置：

1. 在项目根目录的package.json中添加配置："type": "module"
2. 打开TS配置文件tsconfig.json，将compilerOptions.module的值修改为ES2022或ESNext
3. 调整项目中所有文件导入路径，补全文件后缀名（ES Module要求导入时必须写全后缀）

辅助排查手段 #

如果修改后仍有问题，可以在Node启动命令中添加--trace-warnings参数，会输出完整的错误栈信息，方便定位具体问题：

node --trace-warnings 你的编译后入口文件路径.js

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