如何同步onPremisesSamAccountName与Moodle用户资料？OAuth2及脚本疑问

一、OAuth2字段未填充的排查原因 #

• 映射配置与权限校验：确认Azure OAuth2应用已申请并获得读取onPremisesSamAccountName的权限（如Directory.Read.All）；同时检查Moodle OAuth2服务的「用户字段映射」中，profile_field_xxx的xxx与自定义字段的短名称完全一致（区分大小写），拼写错误会导致映射失效。
• OAuth返回字段缺失：开启Moodle调试模式（站点管理→报告→调试），查看OAuth2回调返回的用户数据，确认onPremisesSamAccountName字段是否被包含。Azure默认可能不返回该字段，需在应用的「令牌配置」中手动添加为可选声明。
• 同步逻辑限制：删除用户重新登录后，Moodle重建用户时可能未触发完整字段同步。可临时将自定义字段的「锁定？」改为「是」测试——锁定状态下Moodle会强制同步该字段的值。
• 日志排查：查看Moodle的OAuth2相关日志（站点管理→服务器→日志），检查是否存在字段映射失败的报错，比如字段不存在、权限不足等信息。

二、数据库修改的可行性分析 #

仅直接修改mdl_user_info_data.data字段不可行，因为该表记录依赖userid（用户ID）和fieldid（自定义字段ID）的关联，单独修改data会导致数据无法被Moodle正确识别。正确操作方式：

1. 从mdl_user_info_field表中查询目标自定义字段的id（即fieldid）；
2. 对每个需要更新的用户：
   • 若mdl_user_info_data中已存在userid和fieldid匹配的记录，更新data字段值，同时将timemodified设为当前时间戳；
   • 若不存在匹配记录，插入新记录，填充userid、fieldid、data、timecreated、timemodified字段。

注意：直接操作数据库风险较高，优先使用Moodle内置API（如core_user_update_user_profile函数）更新用户资料，能保证数据一致性并触发系统事件。若必须写脚本，务必先备份数据库，在测试环境验证后再部署到生产环境。

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