Jest 测试报 “Cannot find module ‘@ai-sdk/rsc‘“ 怎么配置 moduleNameMapper

Jest 测试报 Cannot find module ai-sdk/rsc 怎么配置 moduleNameMapper【免费下载链接】aiThe AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents项目地址: https://gitcode.com/GitHub_Trending/ai/ai如果你在用 AI SDK 的ai-sdk/rsc包编写 React Server Components并用 Jest 为这些 RSC 组件写测试运行测试时可能会看到这样的报错Cannot find module ai-sdk/rsc这个错误不是依赖没装而是 Jest 默认解析不到这个包的入口文件。解决方法是在 Jest 配置里通过moduleNameMapper显式告诉 Jest 去哪里找ai-sdk/rsc的编译产物。确认你遇到了这个场景根据项目排查文档 Jest: cannot find module ai-sdk/rsc这个错误出现在以下条件同时成立时项目中使用了 AI SDK RSCai-sdk/rsc包正在用 Jest 为 RSC 组件编写测试测试运行时报出Cannot find module ai-sdk/rsc。如果你的报错不是这条信息或者你用的测试框架不是 Jest本文的结论不直接适用。为什么 Jest 解析不到这个包看一下 packages/rsc/package.json 可以确认两点事实该包声明了type: module是 ESM 包它的exports字段只为react-server、import、default等条件提供入口且入口都指向./dist/目录下的文件如./dist/rsc-client.js。Jest 按 CommonJS 规则解析模块时遇到这种只有 ESM 条件导出的包会找不到可用入口于是抛出Cannot find module。所以修复思路是在 Jest 侧把ai-sdk/rsc手动映射到dist目录。在 jest.config.js 中配置 moduleNameMapper打开你项目的jest.config.js或对应的 Jest 配置文件在moduleNameMapper中加入如下映射moduleNameMapper: { ^ai-sdk/rsc$: rootDir/node_modules/ai-sdk/rsc/dist }各部分说明^ai-sdk/rsc$正则匹配测试中import ... from ai-sdk/rsc这类写法只命中包名本身rootDirJest 内置变量指向项目根目录即 Jest 配置所在的项目目录node_modules/ai-sdk/rsc/dist指向ai-sdk/rsc的编译产物目录与 packages/rsc/package.json 中exports声明的./dist/入口位置一致。如果你的项目使用jest.config.ts或jest.config.mjs写法相同只是把这段moduleNameMapper放进对应格式的导出对象里即可映射的键值保持原文不变。验证配置是否生效配置完成后重新运行之前报Cannot find module ai-sdk/rsc的那条 Jest 测试npx jest修复生效的表现是原先的Cannot find module ai-sdk/rsc不再出现测试能正常加载ai-sdk/rsc提供的函数如streamUI、createStreamableUI等并继续执行断言。如果换了错误信息比如语法错误或断言失败说明模块解析问题已解决剩下的属于测试代码本身的问题与本次映射配置无关。相关限制AI SDK RSC 概览 中标注ai-sdk/rsc目前仍处于实验阶段官方建议生产环境使用 AI SDK UI如果你的项目还在选型阶段可以从该文档的迁移指引了解从 RSC 到 UI 的切换路径。本映射只解决 Jest 下的模块解析问题它不影响 Next.js 等框架在构建时的解析行为也不需要修改ai-sdk/rsc包本身。【免费下载链接】aiThe AI Toolkit for TypeScript. From the creators of Next.js, the AI SDK is a free open-source library for building AI-powered applications and agents项目地址: https://gitcode.com/GitHub_Trending/ai/ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考