diff --git a/docs/uniCloud/schema.md b/docs/uniCloud/schema.md
index 31a95e6c9b256ef220275a33b278c0f7dc37c68e..a295a78f7ee68b0ab66ca3d4f0879bc0a3eb1d2f 100644
--- a/docs/uniCloud/schema.md
+++ b/docs/uniCloud/schema.md
@@ -1693,6 +1693,14 @@ db.collection('street').where("shop_id=='123123'").get()
 db.collection('street').where("shop_id=='123123 || shop_id=='456456'").get()
 ```
 
+### 权限错误排查步骤@handler-permission-error
+
+非jql不会走权限校验，jql报了权限校验未通过从以下几点进行检查
+
+- 连的是云端还是本地，如果是云端检查下schema有没有上传到云端
+- 字段级有没有配置权限，有没有在客户端访问password字段
+- 此次访问的数据是不是配置的权限对应的数据的子集
+
 ## schema2code代码生成系统@autocode
 
 `DB Schema`里有大量的信息，其实有了这些信息，前端将无需自己开发表单维护界面，uniCloud可以自动生成新增、修改、列表、详情的前端页面，以及admin端的列表、新增、修改、删除全套功能。