yarn create next-app执行报错但create-react-app正常，该如何解决？

报错产生原因 #

该报错常见触发原因有两类：

• 当前稳定版Next.js要求Node.js版本最低为18.17.0，若本地Node.js版本低于该要求，会直接触发创建流程报错。你使用create-react-app无同类问题，是因为create-react-app对旧版Node.js的兼容阈值更低，不会触发版本校验拦截。
• 包管理工具缓存损坏、配置的镜像源连接不稳定，导致create-next-app的相关依赖拉取失败，也会触发该报错。

修复方案 #

按优先级依次尝试以下操作即可：

1. 先校验本地Node.js版本，执行命令node -v查看版本号，若低于18.17.0，先将Node.js升级到20.x LTS等符合要求的版本，升级完成后重新执行创建命令即可。
2. 若Node.js版本符合要求，先清理yarn本地缓存后重试：

yarn cache clean
yarn create next-app appname

3. 如清理缓存后仍报错，可以换用其他包管理工具执行创建命令，规避yarn本身的配置问题：

• 使用npm执行：npx create-next-app@latest appname
• 使用pnpm执行：pnpm create next-app appname

4. 若确认是镜像源拉取失败，可以临时切换为官方npm源后重试：

yarn config set registry https://registry.npmjs.org/
yarn create next-app appname

创建完成后可再自行切回常用的国内镜像源。

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