创建Component时Strapi崩溃问题求助

问题现象 #

按快速入门指南安装Strapi，安装流程正常，可访问管理面板、创建新的Collection type，但创建Component时程序直接崩溃，报错信息如下：

⠸ Loading Strapi[ERROR]  There seems to be an unexpected error, try again with --debug for more information

TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received undefined
at new NodeError (node:internal/errors:399:5)
at validateString (node:internal/validators:163:11)
at Object.join (node:path:429:7)
at D:\code\strapi\strapi\node_modules\@strapi\strapi\dist\core\loaders\components.js:17:31
at Array.forEach (<anonymous>)
at D:\code\strapi\strapi\node_modules\@strapi\strapi\dist\core\loaders\components.js:14:32
at Array.reduce (<anonymous>)
at Object.loadComponents (D:\code\strapi\strapi\node_modules\@strapi\strapi\dist\core\loaders\components.js:13:27)
at async Strapi.loadComponents (D:\code\strapi\strapi\node_modules\@strapi\strapi\dist\Strapi.js:320:23)
at async Promise.all (index 6)

项目package.json内容 #

{  
  "name": "strapi",  
  "private": true,  
  "version": "0.1.0",  
  "description": "A Strapi application",  
  "scripts": {    
    "develop": "strapi develop",    
    "start": "strapi start",    
    "build": "strapi build",    
    "strapi": "strapi",    
    "deploy": "strapi deploy"  
  },  
  "devDependencies": {},  
  "dependencies": {    
    "@strapi/strapi": "4.25.3",    
    "@strapi/plugin-users-permissions": "4.25.3",    
    "@strapi/plugin-i18n": "4.25.3",    
    "@strapi/plugin-cloud": "4.25.3",    
    "better-sqlite3": "8.6.0",    
    "react": "^18.0.0",    
    "react-dom": "^18.0.0",    
    "react-router-dom": "5.3.4",    
    "styled-components": "5.3.3"  
  },  
  "author": {    
    "name": "A Strapi developer"  
  },  
  "strapi": {    
    "uuid": "abfd60a1-e7e4-4976-a053-f5fa30602141"  
  },  
  "engines": {    
    "node": ">=18.0.0 <=20.x.x",    
    "npm": ">=6.0.0"  
  },  
  "license": "MIT"
}

已尝试的解决方法 #

• 删除node_modules并重新安装依赖
• 删除项目文件夹后重新创建项目，问题仍未解决

解决方案 #

1. 检查组件配置文件
   报错指向组件加载器的路径拼接错误，手动检查src/components目录：

   • 确保每个组件都有完整的文件夹结构，无空文件夹
   • 检查所有component.json文件格式是否正确，无语法错误或缺失字段

2. 降级Strapi版本
   当前使用的4.25.3版本可能存在已知bug，尝试降级到4.25.2：

   npm install @strapi/strapi@4.25.2 @strapi/plugin-users-permissions@4.25.2 @strapi/plugin-i18n@4.25.2 @strapi/plugin-cloud@4.25.2
   

   安装完成后重新启动项目

3. 切换Node.js版本
   尝试切换到Node.js 18.x稳定版本（如18.18.0），用nvm等工具切换后，重新安装依赖并启动项目

4. 禁用Cloud插件
   移除@strapi/plugin-cloud插件，避免本地开发时的路径冲突：

   npm uninstall @strapi/plugin-cloud
   

   同时删除package.json中对应的依赖项，再重启项目

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