使用Yarn安装Strapi项目时date-fns index.js文件缺失报错求助

在新笔记本上安装数月前创建的Strapi项目时，持续触发以下报错：

Error: Cannot find module '/ppl-cms/node_modules/date-fns/index.js'. Please verify that the package.json has a valid "main" entry

已尝试过的方案：

• 更换Node版本
• 删除node_modules和yarn.lock文件后重新安装依赖
• 更新Strapi版本

当前环境信息：

• Strapi Version: 4.17.0
• Operating System: macOS Sonoma 14.3.1
• Database: sqlite
• Node Version: 20.11.1
• NPM Version: 10.2.4
• Yarn Version: 1.22.21
• 安装的date-fns版本：2.30.0

1. 检查date-fns的package.json配置
   进入项目的node_modules/date-fns目录，查看根目录下的package.json里的main字段是否正确。正常情况下date-fns v2.x的main应该指向index.js，如果字段缺失或路径错误，手动修改为：

   "main": "index.js"
   

   修改后保存，重启Strapi服务测试。

2. 强制重新安装date-fns
   直接指定版本重新安装，避免缓存导致的异常：

   yarn add date-fns@2.30.0 --force
   

   或使用npm：

   npm install date-fns@2.30.0 --force
   

3. 清理Yarn缓存后重装依赖
   Yarn缓存可能导致依赖安装不完整，执行以下命令清空缓存后重新安装：

   yarn cache clean
   rm -rf node_modules yarn.lock
   yarn install
   

4. 排查项目中的自定义导入路径
   检查项目代码里是否有硬编码引用date-fns/index.js的地方，date-fns v2.x推荐使用模块化导入（如import { format } from 'date-fns'），如果存在硬编码路径，改成标准导入方式。

5. 降级date-fns到稳定版本
   如果2.30.0版本确实存在异常，尝试降级到已知稳定的版本（比如2.29.3）：

   yarn add date-fns@2.29.3
   

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