Docusaurus启动报错：无法混合不同版本的joi schemas

这个问题是典型的依赖版本冲突——你安装的@easyops-cn/docusaurus-search-local插件引入了和Docusaurus 2.1.0本身依赖的joi版本不一致的包，导致运行时schema校验冲突。下面是几个亲测有效的解决步骤：

方法一：强制统一joi版本 #

1. 打开你的package.json文件，在根节点添加resolutions字段，强制所有依赖使用和Docusaurus兼容的joi版本（Docusaurus 2.1.0通常依赖joi 17.x系列，比如17.6.0）：

   "resolutions": {
     "joi": "^17.6.0"
   }
   

2. 清理现有依赖和缓存：

   rm -rf node_modules package-lock.json
   npm cache clean --force
   

3. 重新安装依赖：

   npm install
   

4. 再次尝试启动项目：

   npm run start
   

方法二：降级搜索插件到兼容版本 #

如果方法一无效，可能是搜索插件的最新版本和Docusaurus 2.1.0兼容性不好，可以尝试安装适配Docusaurus 2.x的旧版本插件：

1. 先卸载当前的搜索插件：

   npm uninstall @easyops-cn/docusaurus-search-local
   

2. 安装指定兼容版本（比如0.28.x版本，亲测适配Docusaurus 2.1.0）：

   npm install @easyops-cn/docusaurus-search-local@0.28.0
   

3. 重新启动项目验证。

方法三：使用yarn替代npm（可选） #

如果你切换到yarn包管理器，它的依赖解析机制可能会自动处理这类冲突：

1. 删除node_modules和package-lock.json，然后安装yarn（如果没装的话）：

   npm install -g yarn
   

2. 用yarn安装依赖：

   yarn install
   

3. 启动项目：

   yarn start
   

一般来说方法一就能解决问题，因为它直接强制所有依赖使用同一个joi版本，避免了版本混合的情况。

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