Appearance
消安行小程序 - 核心业务问题排查指南
适用对象：运维客服、技术支持
最后更新：2026-11-08
覆盖端：小安星学员端小程序
一、登录问题（高频）
场景 1：小程序登录提示「当前操作没有权限」
这是最常见的登录失败表现，通常由以下几种情况引起。请先与学员确认实际情况，再按对照表处理：
| 学员情况 | 处理方式 |
|---|---|
| 手机号从未开通账号 | 联系管理员在消安行管理平台开户 |
| 之前能正常登录，现在提示无权限 | 账号可能被停用，联系管理员在消安行管理平台 → 用户管理 → 启用账号 |
| 机构刚开通、学员还未分配账号 | 联系管理员确认机构是否已开通系统，并为学员分配账号 |
| 学员更换了微信号 | 见下方「换微信号后无法登录」处理流程 |
| 手机号输错了 | 确认学员使用的手机号与开通账号时登记的号码一致 |
换微信号后无法登录（高频）
学员更换微信号后无法登录，需管理员先解除原微信绑定，学员再重新登录：
管理员操作：
- 登录消安行管理平台（https://manage.xiaoanxing.net）
- 进入「用户管理」→ 搜索该学员手机号
- 点击「重置微信登录」按钮
学员操作：
- 退出小程序
- 重新打开小程序
- 点击「一键登录」
- 系统会自动绑定新的微信号
场景 2：小程序退出登录后无法切换账号
现象：学员退出登录后，再次点击「一键登录」直接登录回原账号，无法切换。
原因： 小程序为节省微信手机号验证的计费成本（按次收费），采用「静默登录」策略：
- 退出时只清除登录状态，不清除微信绑定信息
- 再次登录时自动使用之前绑定的微信号，不弹授权窗
解决方案：
| 方案 | 操作步骤 | 适用场景 |
|---|---|---|
| 方案 A：退出小程序 | 右上角「…」→「退出小程序」→ 重新打开 | 切换同一微信的不同账号 |
| 方案 B：切换微信 | 微信切换账号 → 重新打开小程序 | 用另一个微信号登录 |
| 方案 C：清除缓存 | 微信 →「…」→「设置」→「清除缓存」→ 重新打开 | 缓存异常时 |
注意：
- 只有用户主动退出后的那一次重新授权会产生微信验证费用
- 登录超时等场景不会清除缓存，保持静默续登（0 费用）
场景 3：登录提示「认证失败，无法访问系统资源」
原因：登录认证超时或无效。
常见场景：
- 长时间未操作，登录认证自然超时
- 系统维护或更新后，认证信息失效
- 网络异常导致认证信息丢失
解决方案：
- 系统会自动弹出「重新登录」确认框 → 点确认 → 跳转登录页
- 如果未自动弹出：手动清除小程序缓存后重新登录
- 如果反复出现：联系技术支持处理
场景 4：登录时提示「您还未注册」
原因：该手机号在系统中不存在。
解决方案：
- 确认手机号是否正确（是否输入错误）
- 确认该学员是否已在消安行管理平台开户
- 联系管理员在「用户管理」中创建账号
场景 5：登录时提示「账号已停用」
原因：该账号被管理员停用。
解决方案：
- 联系管理员在消安行管理平台 → 用户管理 → 找到该学员
- 将账号状态从「停用」改为「正常」
- 学员退出重新登录
二、权限问题
场景 1：进入某个功能提示「暂无权限」
排查步骤：
第一步：确认角色权限配置
- 管理员登录消安行管理平台
- 进入「系统管理」→「角色管理」
- 找到该学员所属角色
- 点击「修改」→ 查看「菜单权限」
- 确认是否勾选了对应功能的权限
第二步：确认用户角色绑定
- 进入「用户管理」→ 找到该学员
- 查看「角色」列，确认是否已分配角色
- 如果未分配：点击「修改」→ 分配对应角色 → 保存
第三步：让学员重新登录
权限信息在登录时加载，修改权限后必须让学员：
- 退出小程序
- 重新登录
这样才会获取最新的权限信息。
场景 2：学员能看到菜单但点进去提示「暂无权限」
原因：
- 菜单权限已授权，但按钮权限未授权
- 页面菜单缓存未更新
解决方案：
- 管理员检查角色的「菜单权限」中是否包含对应的按钮权限
- 学员退出重新登录
- 清除小程序缓存后重试
场景 3：部分学员有权限，部分学员没权限
排查思路：
- 对比角色：检查有权限和没权限的学员是否属于同一角色
- 对比租户：确认是否跨租户问题（超管 vs 普通租户）
- 对比登录时间：权限修改后是否重新登录
常见原因：
- 权限修改后，部分学员已重新登录（获取新权限），部分未重新登录（仍是旧权限）
- 不同租户的管理员各自管理自己的角色权限，配置不一致
三、课程与权限问题
场景 1：学员进入课程提示「课程已过期」
排查步骤：
确认课程权限是否真的到期
- 管理员登录消安行管理平台
- 进入「学员管理」→ 找到该学员
- 点击「课程权限」→ 查看到期时间
如果权限未到期但仍提示过期
- 可能是页面缓存问题
- 学员退出重新登录
- 清除小程序缓存后重试
如果权限确实到期
- 联系管理员续费或重新开通课程权限
场景 2：学员已购买套餐但无法学习
排查步骤：
确认订单状态
- 管理员登录消安行管理平台
- 进入「学员管理」→ 找到该学员
- 查看「课程权限」是否有对应套餐的记录
确认权限是否已开通
- 如果订单已付款但无权限记录：可能是开课流程异常
- 联系技术支持协助处理
手动开通权限
- 在「课程权限」页面点击「开通套餐」
- 选择对应套餐 → 确认开通
场景 3：学员学习进度不更新
原因：
- 网络提交失败
- 页面缓存未更新
- 系统异常
解决方案：
- 检查网络连接，重新提交
- 退出重新登录，刷新页面缓存
- 如果仍未解决，联系技术支持协助处理
四、退费问题
场景 1：学员要求退费
答案：学员不能自助退费，需联系管理员或销售处理。
退费流程：
流程 A：管理端直接退费（3 天内）
适用条件：消费流水在 3 天内
- 管理员登录消安行管理平台
- 进入「账单管理」→ 找到对应消费流水
- 点击「退费」按钮（超期订单按钮禁用，显示「已超期」标签）
- 填写退费备注 → 确认退费
退费后：
- 退费金额原路返回机构余额（实时到账）
- 课程权限自动撤销（按时长反向扣减）
- 生成退费流水记录
流程 B：CRM 退款审批（3 天内）
适用条件：CRM 订单收款后 3 天内
- 销售登录消安行 CRM（https://crm.xiaoanxing.net）
- 进入「订单管理」→ 找到对应订单
- 点击「申请退款」按钮（收款超过 3 天的订单不再显示该按钮，状态列显示「已超期」）
- 填写退款原因 → 提交申请
- 等待管理员审批：
- 审批通过 → 自动执行退费 + 撤销课程权限
- 审批驳回 → 订单恢复正常状态，可重新申请
注意：
- 管理端退费和 CRM 退款都要求在收款后 3 天内办理，超过 3 天均无法退费
- CRM 订单只能从 CRM 退费，管理端会拦截（提示「该订单由 CRM 系统开通，请前往 CRM 系统提交退款申请」）
场景 2：退费后课程权限未回收
排查步骤：
确认退费是否成功
- 管理员登录消安行管理平台
- 进入「账单管理」→ 查看退费流水是否已生成
确认权限状态
- 进入「学员管理」→ 找到该学员
- 查看「课程权限」→ 确认权限是否已撤销
如果权限未回收
- 可能是退费流程中断，联系技术支持协助处理
场景 3：退费后余额未到账
排查步骤：
确认退费流水
- 管理员登录消安行管理平台
- 进入「账单管理」→ 查看退费流水记录
确认租户余额
- 进入「租户管理」→ 找到对应租户
- 查看余额是否已恢复
如果余额未恢复
- 可能是余额更新延迟，联系技术支持协助处理
五、练习与考试问题
场景 1：练习/模拟考无法加载
排查步骤：
确认课程权限
- 确认已购买对应课程套餐
- 确认课程权限在有效期内
确认题库配置
- 管理员登录消安行管理平台
- 进入「题库管理」→ 确认题库已关联到课程
- 确认题库状态为「已发布」
确认权限已开通
- 进入「学员管理」→ 课程权限 → 确认权限已开通
解决方案：
- 退出重新登录，刷新页面缓存
- 管理员确认课程权限和题库配置是否正确
场景 2：模拟考试成绩不更新
原因：
- 网络提交失败
- 系统异常
- 页面缓存未更新
解决方案：
- 检查网络连接，重新提交试卷
- 退出重新登录，刷新页面缓存
- 联系管理员协助处理
场景 3：错题本为空
原因：
- 学员还没有做题记录
- 页面缓存未更新
解决方案：
- 确认学员是否做过题（练习/模拟考）
- 退出重新登录，刷新页面缓存
- 如果仍未解决，联系技术支持协助处理
附录：常用管理入口
| 功能 | 入口 | 地址 |
|---|---|---|
| 学员管理 | 消安行管理平台 → 学员管理 | https://manage.xiaoanxing.net |
| 课程权限 | 消安行管理平台 → 学员管理 → 课程权限 | https://manage.xiaoanxing.net |
| 账单管理 | 消安行管理平台 → 账单管理 | https://manage.xiaoanxing.net |
| 反馈管理 | 消安行管理平台 → 反馈管理 | https://manage.xiaoanxing.net |
| CRM 订单 | 消安行 CRM → 订单管理 | https://crm.xiaoanxing.net |
| CRM 退款审批 | 消安行 CRM → 退款待审批 | https://crm.xiaoanxing.net |
附录：常见排查建议
排查思路
遇到问题时，建议按以下顺序排查：
- 先确认操作是否正确：检查操作步骤是否符合本文档描述
- 清除缓存重试：退出重新登录，或清除小程序/页面缓存后重试
- 联系管理员：确认账号状态、权限配置、课程权限是否正常
- 联系技术支持：提供学员手机号、操作时间、具体提示信息，由技术支持协助定位问题
提供问题描述模板
联系技术支持时，请尽量提供以下信息，便于快速定位：
| 信息 | 说明 |
|---|---|
| 学员手机号 | 登录小程序使用的手机号 |
| 操作时间 | 问题发生的大致时间 |
| 操作页面 | 在哪个页面操作时出现问题 |
| 问题描述 | 具体现象、提示信息截图 |
清除页面缓存
| 端 | 操作 |
|---|---|
| 小程序 | 微信 →「…」→「设置」→「清除缓存」 |
| PC 浏览器 | Ctrl + Shift + Delete（Windows）/ Cmd + Shift + Delete（Mac） |
文档版本：v2.0
最后更新：2026-11-08
维护人员：技术支持团队