更新Schema字段后Sanity项目Desk与Vision工具崩溃求助

问题详情 #

原本运行正常的Sanity.io Desk和Vision标签页，在更新Schema字段并完成构建部署后出现崩溃，报错信息如下：

Error: Workspace: missing context value
Error: Workspace: missing context value
    at DJ (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:7757:1969)
    at pr (https://avantgardeservice.sanity.studio/static/index-990e561a-d62f5f2c.js:187:1382)
    at FU (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:66:19598)
    at IL (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:68:3155)
    at E8e (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:68:44781)
    at $8e (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:68:39950)
    at yvt (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:68:39873)
    at T3 (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:68:39723)
    at VL (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:68:36071)
    at w8e (https://avantgardeservice.sanity.studio/static/sanity-54893e46.js:68:35017)

项目package.json配置：

{
  "name": "sanity-project",
  "private": true,
  "version": "1.0.0",
  "main": "package.json",
  "license": "UNLICENSED",
  "scripts": {
    "dev": "sanity dev",
    "start": "sanity start",
    "build": "sanity build",
    "deploy": "sanity deploy",
    "deploy-graphql": "sanity graphql deploy"
  },
  "keywords": [
    "sanity"
  ],
  "dependencies": {
    "@sanity/vision": "^3.15.1",
    "react": "^18.2.0",
    "react-dom": "^18.2.0",
    "react-is": "^18.2.0",
    "sanity": "^3.15.1",
    "styled-components": "^5.3.9"
  },
  "devDependencies": {
    "@sanity/eslint-config-studio": "^3.0.0",
    "@types/react": "^18.0.25",
    "@types/styled-components": "^5.1.26",
    "eslint": "^8.6.0",
    "prettier": "^2.8.8",
    "typescript": "^4.9.5"
  },
  "prettier": {
    "semi": false,
    "printWidth": 100,
    "bracketSpacing": false,
    "singleQuote": true
  }
}

已尝试将Schema恢复至更新前状态，但错误仍未解决。

解决办法 #

• 清理本地缓存并重新构建

  1. 删除本地.sanity缓存目录
  2. 执行npm install确保依赖无损坏
  3. 运行sanity build重新构建项目后再次部署

• 检查Studio配置文件
  确认sanity.config.ts（或.js）中：

  • 所有插件（尤其是Vision）的注册方式正确，没有缺失必要的上下文传递
  • Workspace配置未出现语法错误或结构异常，比如未正确导出defineConfig

• 强制刷新部署版本
  执行sanity deploy --clean，该命令会清理远程部署缓存并重新上传最新构建文件

• 升级Sanity版本
  当前使用的sanity和@sanity/vision版本为3.15.1，存在已知的上下文相关bug，升级至最新稳定版：

  1. 执行npm install sanity@latest @sanity/vision@latest
  2. 重新构建并部署

• 检查远程数据集配置
  登录Sanity管理后台，确认数据集的权限配置、API访问规则无变更，避免因权限问题导致上下文加载失败

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