智学网排名未更新通常因成绩未发布、排名开关未开启、系统同步延迟、缓存未刷新或权限不足；需依次检查发布状态、启用排名设置、等待整点计算、强制刷新缓存、核验账号权限。
如果您在智学网查看班级或年级排名时发现数据未更新、排名停滞、名次与实际成绩不符，通常是因为系统尚未完成成绩计算、发布流程或数据同步尚未完成。以下是排查与应对的具体操作步骤：
一、确认成绩是否已正式发布
排名数据依赖于教师端已完成“成绩录入→审核→发布”全流程。若成绩仍处于“草稿”“待审核”或“已录入但未发布”状态，学生/家长端将无法触发排名计算逻辑，所有排名字段均维持上一次发布值或显示为空白。
1、登录教师端，进入“考试管理→成绩录入”模块，查找对应考试名称。
2、点击该考试右侧的“详情”按钮，查看当前状态栏是否显示“已发布”字样。
3、如状态为“已录入”“待审核”或无状态标识，需联系阅卷组长或教务管理员执行发布操作。
二、检查考试设置中的排名开关与统计范围
智学网默认不自动启用排名功能，需管理员在考试配置中手动开启“生成班级/年级排名”，并指定参与统计的学生范围（如：是否包含缺考、免考、休学等特殊状态学生）。若该开关关闭或范围设置过窄，会导致部分学生缺失排名或整体排名延迟生成。
1、管理员登录后台，进入“考试管理→考试设置→高级选项”。
2、定位到“启用排名统计”复选框，确认其已被勾选。
3、查看“参与排名的学生范围”下拉菜单，确保选择为“全部参考学生”或符合当前教学场景的准确范围。
三、等待系统定时同步任务执行
智学网采用异步批处理机制生成排名数据，非实时刷新。成绩发布后，系统会在整点（如10:00、11:00、14:00等）触发统一计算任务，单次处理耗时约3–8分钟，期间排名页面可能持续显示旧数据或加载中提示。
1、记录成绩发布的具体时间（精确到分钟），例如“2026-02-06 15:42发布”。
2、观察后续最近一个整点（如16:00）之后的20分钟内，刷新“成绩分析→排名”页面。
3、若至下一个整点（如17:00）后仍未更新，需判断是否触发失败——此时页面通常显示“数据计算中，请稍候”且持续超过15分钟。
四、清除本地缓存并强制刷新数据接口
浏览器或App本地缓存可能锁定旧版排名JSON响应，导致即使服务器已更新，前端仍渲染历史快照。此问题在使用Chrome/Firefox桌面端及iOS App中高频出现。
1、在排名页面按快捷键Ctrl+Shift+R（Windows）或 Cmd+Shift+R（Mac）执行硬性重载。
2、打开浏览器开发者工具（F12），切换至Network标签页，勾选“Disable cache”，再刷新页面。
3、在Network列表中查找以/api/v2/rank/list结尾的请求，点击进入Headers面板，确认Response中"X-Data-Timestamp"字段值较上次有更新。
五、验证账号角色与数据权限隔离
智学网实行严格的多维度数据权限控制。教师账号若仅被授予“学科阅卷”权限而未配置“班级管理”或“年级分析”角色，则其查看的排名仅限所教班级局部数据；学生/家长账号则受限于绑定关系，仅能查看该生所在班级内排名，无法跨班、跨年级呈现完整序列。
1、学生端登录后，点击右上角头像→“我的信息”，核对“所属班级”与“所属年级”是否与当前查询场景一致。
2、教师端进入“系统设置→我的权限”，展开“成绩分析”模块，确认已勾选“查看年级总排名”与“导出完整排名表”两项权限。
3、如使用学校定制域名（如school.zhixue.com），需额外确认该子域是否已开通排名模块授权——部分学校采购版本默认关闭此功能。
