新建Gatsby项目后出现Minified React error #31错误是什么原因？

问题原因 #

1. 启动命令使用错误：gatsby serve 仅用于预览已完成构建的生产环境产物，执行前需要先运行 gatsby build 生成对应的构建缓存和产物文件，你未提前执行构建操作，导致运行时找不到必需的 .cache/match-paths.json 文件，触发报错。
2. 全局安装 gatsby-cli 出现的 hapi 相关依赖漏洞属于工具本身的依赖安全提示，和本次启动报错无直接关联，不会影响项目正常运行。

解决方案 #

• 如果需要启动开发调试服务，直接运行以下命令即可，不需要提前构建：

gatsby develop

• 如果需要预览生产环境效果，先执行构建命令再启动预览服务：

gatsby build
gatsby serve

• 若执行上述操作后仍有异常，先清理缓存和依赖重装再重试：

rm -rf node_modules .cache package-lock.json
npm install

额外注意事项 #

你当前使用的 Node.js 12.22 版本已终止官方维护，最新版 Gatsby 不再支持该版本，若后续出现兼容性问题，可选择将 Gatsby 降级到 v4 系列（最后一个支持 Node 12的版本），或将 Node.js 升级到 14.x 及以上的 LTS 版本。

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