安装Strapi时出现TypeError: Cannot read properties of undefined (reading 'addBreadcrumb')错误

问题详情 #

• 环境：Node.js v20.12.2，npm@10.5.2
• 执行命令：npx create-strapi-app@latest pdf-invoice-generator --quickstart
• 报错内容：TypeError: 无法读取未定义的属性（读取'addBreadcrumb'）
• 错误溯源：错误栈指向@strapi/generate-new包内相关文件，完整日志路径：C:\Users\Tarek\AppData\Local\npm-cache\_logs\2024-04-16T19_07_56_753Z-debug-0.log

可行解决方案 #

• 清理npm缓存后重试
  执行以下命令清理缓存，再重新运行项目创建命令：

  npm cache clean --force
  npx create-strapi-app@latest pdf-invoice-generator --quickstart
  

• 指定Strapi稳定版本安装
  最新版Strapi可能存在兼容性问题，尝试指定已知稳定版本（如4.25.0）：

  npx create-strapi-app@4.25.0 pdf-invoice-generator --quickstart
  

• 降级Node.js版本
  Node.js 20.x与当前Strapi版本可能存在适配问题，建议降级至18.x LTS版本，完成后再执行创建命令。
• 手动初始化项目
  1. 创建并进入空文件夹：

     mkdir pdf-invoice-generator && cd pdf-invoice-generator
     

  2. 初始化npm项目：

     npm init -y
     

  3. 安装Strapi：

     npm install strapi@latest
     

  4. 启动开发模式：

     npx strapi develop
     

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