Windows 11下使用Sanity CLI执行yarn create时出现Request failed "304 Not Modified"错误

API 探路者

2026-4-14

我之前也碰到过类似的Yarn缓存导致的304错误，结合你已经尝试过的清理缓存、重装Node、切换Node版本等操作，给你几个更针对性的解决思路：

强制彻底清理Yarn缓存
普通的yarn cache clean可能没完全清掉损坏的缓存文件，试试带强制参数的清理命令：
```
yarn cache clean --force
```
清理完成后，建议加上超时参数重新执行Sanity创建命令，避免网络波动影响：
```
yarn create sanity@latest --project wl1d7zqt --dataset production --template clean --typescript --output-path studio-yc_directory --network-timeout 100000
```
换用npm工具初始化项目
你用的Yarn 1.22.22版本比较老旧，和Node.js 23这种较新的测试版可能存在兼容性问题，直接用npm的npx来创建Sanity项目试试：
```
npx create-sanity@latest --project wl1d7zqt --dataset production --template clean --typescript --output-path studio-yc_directory
```
手动删除Yarn缓存目录
如果命令行清理缓存无效，可以直接手动删除Yarn的缓存文件夹：
打开文件管理器，导航到C:\Users\malan\AppData\Local\Yarn\Cache，删除该文件夹下的所有内容（或者直接删掉整个Cache文件夹），之后再重新运行创建命令。
排查网络与Registry配置
304错误也可能和网络代理、VPN或者镜像源的缓存有关：
- 如果你正在使用代理或VPN，先暂时关闭它们再尝试拉取依赖
- 可以临时切换到国内的npm镜像源，绕开官方源的缓存问题：
```
yarn config set registry https://registry.npmmirror.com/
```
  项目创建完成后，若需要可以再切回官方源：
```
yarn config set registry https://registry.npmjs.org/
```
升级到Yarn现代版（Berry）
Yarn 1.x已经进入维护状态，和新Node版本的兼容性会越来越差，你可以升级到Yarn Berry（v2及以上版本）：
```
npm install -g yarn@berry
```
升级完成后再执行你的Sanity创建命令，新版本的Yarn在缓存管理和网络请求处理上有明显优化。