Strapi项目执行npm run start触发ERR_INVALID_ARG_TYPE错误求助

错误信息 #

TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object. Received undefined

环境信息 #

• Node.js版本：v16.16.0
• npm版本：8.11.0
• Strapi版本：4.4.7

可能的原因 #

• 核心配置文件存在未定义参数：config/server.js、config/database.js等配置文件中，必填项被设为undefined或未赋值，Strapi启动读取时触发类型校验错误。
• 依赖包损坏或版本冲突：安装依赖过程中文件损坏，或部分依赖版本与当前Strapi/Node.js版本不兼容，导致方法调用时传入无效参数。
• 自定义代码存在参数缺失：新增的插件、控制器、路由或钩子代码中，调用方法时未传入必填的第一个参数（比如fs.readFile、Buffer.from等方法），导致接收到undefined。

解决方法 #

1. 检查配置文件 #

• 遍历config/目录下的所有配置文件，确保server.js里的host、port，database.js里的host、database、username等必填项均有合法赋值，没有出现未定义的变量或空值。
• 若使用环境变量，确认.env文件中的变量已正确定义，且配置文件中通过process.env.XXX读取时不会返回undefined。

2. 重新安装依赖 #

• 删除项目根目录的依赖文件和锁文件：

  rm -rf node_modules package-lock.json
  

• 重新安装依赖：

  npm install
  

• 再次尝试启动项目：

  npm run start
  

3. 排查自定义代码 #

• 回顾近期新增的自定义代码，检查是否存在调用方法时遗漏第一个参数的情况，比如调用数据库查询、文件操作相关方法时，确保传入的参数类型合法。
• 临时移除所有自定义代码，重启项目验证错误是否消失，若消失则逐步恢复代码定位问题点。

4. 调整版本兼容性 #

• Strapi 4.4.7与Node.js 16.x兼容，但可尝试将Node.js升级至16.x系列的稳定版本（如v16.20.2），或把Strapi升级至4.4.7之后的小版本（如4.4.10），排除版本适配问题。

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