1

doc/WPS365授权错误排查指南.md

@@ -1,6 +1,8 @@
 # WPS365 授权错误排查指南
 
-## 错误信息
+## 常见错误类型
+
+### 1. invalid_request (40000001) - redirect_uri不匹配
 
 ```json
 {
@@ -12,14 +14,31 @@
 }
 ```
 
-## 错误含义
+**错误含义**：redirect_uri参数值与WPS365平台配置的回调地址不一致
 
-这个错误可能由以下原因导致：
+### 2. invalid_scope (40000005) - scope权限无效 ⚠️
+
+```json
+{
+  "code": 40000005,
+  "msg": "invalid_scope",
+  "debug": {
+    "desc": "The requested scope is invalid, unknown, or malformed. The OAuth 2.0 Client is not allowed to request scope 'file.read,ksheet.read,user.info'."
+  }
+}
+```
+
+**错误含义**：请求的scope权限格式不正确，或者应用未申请这些权限
+
+## 错误含义总览
+
+授权错误可能由以下原因导致：
 
 1. **缺少必需参数** - 授权请求中缺少某个必需的参数
 2. **参数值无效** - 某个参数的值格式不正确
 3. **参数重复** - 某个参数在请求中出现了多次
 4. **redirect_uri不匹配** - redirect_uri参数值与WPS365平台配置的回调地址不一致
+5. **scope无效** - scope权限格式不正确或未申请
 
 ## 排查步骤