使用Moodle API与Node.js创建Moodle用户时报token无效错误

核心排查方向 #

1. Token绑定匹配问题 #

• 从web服务令牌配置页获取的token，必须明确关联到你创建的「My Service」自定义外部服务，不能使用未绑定对应服务的通用测试token，否则调用时会直接判定token无效
• 核对token基础属性：确认token未设置过期时间、未被手动停用、未配置访问IP限制，当前Node.js运行环境的公网出口IP需要落在token允许的IP访问范围内

2. 请求传参格式异常导致Token识别失败 #

• 你当前的代码使用axios默认POST配置，会以application/json作为Content-Type发送请求体，而多数Moodle版本的REST服务默认不会解析JSON格式的请求体，会直接忽略body中携带的wstoken参数，将请求判定为无token的匿名访问，最终返回token not found的XML格式异常，与你当前收到的错误表现完全匹配
• 修正方式：给请求显式设置Content-Type: application/x-www-form-urlencoded，或将wstoken、wsfunction、moodlewsrestformat这类公共参数作为URL查询参数传递，避免参数无法被服务端识别

3. 外部服务配置漏项检查 #

• 确认「My Service」已勾选“允许使用REST协议”开关，且Moodle站点的web服务总配置中，REST传输协议处于全局启用状态
• 核对分配给服务的core_user_create_users功能已启用，关联token的用户角色具备moodle/user:create的系统权限

快速验证调试步骤 #

• 先构造最简单的GET请求，将测试token作为查询参数直接拼接在服务地址后，调用低权限的core_webservice_get_site_info基础接口做连通性测试：
  • 如果该基础接口同样返回invalidtoken，说明问题出在token本身的绑定、IP限制、权限配置环节
  • 如果该基础接口返回正常站点信息，说明问题出在POST请求的传参格式上，按前述方式调整请求头和参数传递方式即可

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