在React项目中安装Strapi时遇SSL加密及未定义属性错误求助

环境信息 #

• Node.js版本：v16.19.0
• npm版本：v8.19.3
• 操作场景：在React项目目录下执行npx create-strapi-app@latest my-project，选择Quickstart模式安装Strapi

完整报错信息 #

PS C:\Users\Rohit\OneDrive\Desktop\E-commerce\api> npx create-strapi-app@latest my-project
? Choose your installation type Quickstart (recommended)
Creating a quickstart project.
Creating a new Strapi application at C:\Users\Rohit\OneDrive\Desktop\E-commerce\api\my-project.
Creating files.
Error while installing dependencies:
npm WARN config production Use `--omit=dev` instead.
npm WARN config optional Use `--omit=optional` to exclude optional dependencies, or
npm WARN config `--include=optional` to include them.
npm WARN config 
npm WARN config     Default value does install optional deps unless otherwise omitted.
npm WARN deprecated source-map-url@0.4.1: See https://github.com/lydell/source-map-url#deprecated
npm WARN deprecated urix@0.1.0: Please see https://github.com/lydell/urix#deprecated
npm ERR! code ERR_SSL_CIPHER_OPERATION_FAILED
npm ERR! 94340000:error:1C800066:Provider routines:ossl_gcm_stream_update:cipher operation failed:c:\ws\deps\openssl\openssl\providers\implementations\ciphers\ciphercommon_gcm.c:320:
npm ERR!

npm ERR! A complete log of this run can be found in: C:\Users\Rohit\AppData\Local\npm-cache\_logs\2023-07-29T15_26_07_183Z-debug-0.log
TypeError: Cannot read properties of undefined (reading 'addBreadcrumb')
    at C:\Users\Rohit\AppData\Local\npm-cache\_npx\2d56dd13733e9da7\node_modules\@strapi\generate-new\dist\utils\usage.js:67:28
    at Array.forEach (<anonymous>)
    at captureStderr (C:\Users\Rohit\AppData\Local\npm-cache\_npx\2d56dd13733e9da7\node_modules\@strapi\generate-new\dist\utils\usage.js:66:14)
    at createProject (C:\Users\Rohit\AppData\Local\npm-cache\_npx\2d56dd13733e9da7\node_modules\@strapi\generate-new\dist\create-project.js:136:41)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)  
    at async createQuickStartProject (C:\Users\Rohit\AppData\Local\npm-cache\_npx\2d56dd13733e9da7\node_modules\@strapi\generate-new\dist\create-quickstart-project.js:21:5)

解决方案 #

该错误源于npm执行SSL加密操作时失败，可按以下步骤尝试解决：

• 清除npm缓存：清理可能损坏的缓存文件，避免干扰依赖安装

  npm cache clean --force
  

• 临时禁用SSL严格校验：绕过加密操作故障，安装完成后可恢复设置

  npm config set strict-ssl false
  # 安装完成后执行以下命令恢复
  npm config set strict-ssl true
  

• 切换npm镜像源：如果是网络或证书问题导致，更换为稳定的镜像源

  npm config set registry https://registry.npmmirror.com/
  

• 手动创建并安装项目：跳过自动安装流程，分步完成Strapi初始化

  # 创建项目目录并进入
  mkdir my-project && cd my-project
  # 初始化npm项目
  npm init -y
  # 手动安装Strapi核心依赖
  npm install @strapi/strapi@latest
  # 初始化Strapi项目
  npx strapi init
  

• 升级npm版本：尝试更新npm到最新稳定版，修复可能存在的版本兼容性问题

  npm install -g npm@latest
  

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