TypeScript运行编译代码时redis模块为undefined的问题求助

问题核心原因 #

Redis v4+版本采用ESM模块规范，不再提供CommonJS风格的默认导出。你用import redis from 'redis'尝试默认导入时，运行时拿到的是undefined——因为该模块没有默认导出整个模块对象，仅提供命名导出的方法（比如createClient）。IDE能自动补全是因为TypeScript类型定义文件仍能识别模块结构，但Node运行时无法找到对应的默认导出，因此触发报错。

解决方案 #

1. 修改导入方式 #

放弃默认导入，直接使用命名导入createClient：

import { createClient } from 'redis';

// 直接调用createClient初始化客户端
const redisClient = createClient({
  // 填入你的Redis配置，例如 url: 'redis://localhost:6379'
});

// 建立连接
redisClient.connect().then(() => {
  console.log('Redis连接成功');
});

2. 确认tsconfig.json配置 #

基于@tsconfig/node16的配置通常已满足要求，但可再检查以下关键项：

{
  "extends": "@tsconfig/node16/tsconfig.json",
  "compilerOptions": {
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "esModuleInterop": true
  }
}

• module和moduleResolution设为NodeNext，能让TypeScript正确处理Node.js 16的ESM/CommonJS混合模块规则；
• esModuleInterop用于兼容部分旧版CommonJS模块，保留不影响Redis v4的使用。

3. 验证Redis版本（可选） #

你提到使用了最新版本，这步可跳过。若你误装了Redis v3及以下版本，虽然可以用import redis from 'redis'的默认导入方式，但仍建议升级到v4以获得更好的TypeScript支持。

额外提示 #

Node.js环境下的TypeScript和React中的TypeScript存在差异：React多遵循浏览器端ESM规则，而Node.js 16+对ESM与CommonJS的区分更严格。遇到模块导入问题时，优先参考模块官方文档的导入示例，不要直接照搬React项目的习惯。

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