解决 401、403、404 和 422 错误

这些状态码对应不同故障，不应只根据通用 Toast 反复重试。

截图展示的是 Participant 写入因请求无效被服务器拒绝后，空间撤销改动并显示本地化错误提示的状态。具体请求的 401、403、404 或 422 会出现在对应操作或浏览器网络响应中，不会作为独立的公开状态页卡片展示。

401：重新登录

请求没有有效会话。重新登录后返回原空间。如果保存修改时遇到 401，Formist 会保留屏幕上的草稿并就地弹出登录提示；完成登录后会自动重新提交同一次保存，不会丢失改动。若每次刷新都会退出，请检查前端/API 域名和 Cookie。

403：没有访问权限

你已登录，但空间角色或外部授权不允许操作。确认当前空间与角色。如果你已被移出该空间，正在编辑的记录会在本次会话中变为只读，并显示提示说明原因，未保存的文字仍会保留在屏幕上。Microsoft 文件或邮件操作也可能因委托授权缺失返回 403，应按提示重新连接或授权。

404：记录不可用

当前空间中找不到 URL 或记录 ID。刷新列表后重新打开。SharePoint 项目被移动、删除或不再对当前 Microsoft 账号可见时也会出现此情况。

422：请求字段无效

检查必填项、日期格式、ID、角色名称和不支持的额外字段。应修正表单，不要原样重试。

反馈问题时可提供 endpoint、method、status、error name 和非敏感字段，不要提供 Cookie 或 Token。

Frequently asked questions

已经登录的情况下为什么还会返回 403？

403 表示你的空间角色或外部授权不允许这个具体操作，而不是会话失效；Microsoft 文件和邮件操作在委托授权缺失时也会返回 403。

404 是否意味着记录已被删除？

不一定。它只表示 URL 或记录 ID 在当前空间中无法解析；SharePoint 项目被移动或对你的 Microsoft 账号不再可见时也会出现这种情况，并不代表在 Formist 中被删除。

收到 422 时应该直接重试吗？

不应该。422 表示服务器拒绝了某些字段；需要先修正表单内容（必填值、日期格式、ID、角色名称）再重新提交。