single-spa运行报ERR_PACKAGE_PATH_NOT_EXPORTED错误如何解决

这个报错是错误导入包内部私有路径触发的Node.js包导出规则校验失败，具体逻辑：

• Node.js 12及以上版本支持package.json中的exports字段做包入口白名单控制：所有没有在exports中显式声明的子路径，即使文件真实存在于node_modules目录下，外部代码也无权直接导入，直接导入就会抛出ERR_PACKAGE_PATH_NOT_EXPORTED错误。
• 你使用的single-spa-layout@2.x版本，并未将dist/types/*这类内部目录路径加入exports白名单，这类路径属于包的私有实现细节，本身就不对外开放。另外dist/types目录存放的是TypeScript类型声明文件，并非可执行的JS运行时代码，从一开始就不应该作为业务代码的导入来源。
• 你需要用到的constructServerLayout、sendLayoutHTTPResponse两个服务端方法，官方已经提供了公开的导出入口，不需要深入内部路径找。

1. 替换原有错误的导入语句，改用官方公开的服务端入口导入，不要引用任何dist/*下的内部路径：

import {
  constructServerLayout,
  sendLayoutHTTPResponse
} from "single-spa-layout/server"

2. 如果修改导入后TypeScript提示找不到对应模块的类型，检查项目tsconfig.json中的moduleResolution配置，将其设置为node16或者nodenext，让TypeScript可以正确识别包exports字段映射的入口路径。如果是老项目不便调整模块解析策略，也可以安装对应的社区类型包补全类型，但优先推荐调整模块解析配置适配现代包规范。

避坑提示：不要通过修改node_modules内包文件、写全绝对路径硬引内部文件的方式绕过校验，包的内部目录结构不属于对外承诺的稳定API，后续升级小版本时随时可能调整，硬引内部路径会留下升级故障隐患。

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