深浅模式
常见问题
功能说明
汇总站点管理员在后台配置与日常运营中最常遇到的问题及处理思路。
前置条件
- 已能登录管理后台（H5）。
- 已知自己的管理员类型：超级管理员、平台管理员或区域管理员。
管理后台配置步骤
以下按 现象 分类，无需单独配置步骤；请对照跳转至对应功能文档。
侧栏菜单没有或显示「未解锁 / 内测中」
可能原因
- 功能模块未授权 — 外卖、AI 中台、UI 管理等需授权后才会出现
- 账号权限不足 — 未分配对应菜单权限，侧栏整组隐藏
- 商户管理内测 — 外卖 / 骑手在未开通前整组可能不可点
处理
- 超级管理员：系统设置 → 账号权限 为账号添加所需权限，或使用 权限模板 批量分配
- 到 系统设置 → 我的模块 确认外卖、AI 中台等是否已开通
- 区域管理员只能看到被授权且 在本区域范围内 的菜单
详见 进入管理后台 与各功能文档前置条件。
操作保存时提示 403 / 无权限
可能原因
- 当前账号缺少对应功能的 修改权限（如系统配置、区域用户规则）
- 区域管理员修改 其他区域 数据被拒绝
- 站点已关闭「遗留全量权限」，未单独分配权限的管理员默认无法保存
处理
- 让超级管理员在 系统设置 → 账号权限 中补充权限
- 区域管理员切换页面顶部 区域筛选 到管辖区域再保存
- 使用 权限模板 批量绑定常用角色
微信登录失败
可能原因
- 系统配置 → 微信小程序 / 公众号 Token 测试未通过
- 区域管理 → 用户配置 未开启对应微信登录开关
- 公众号 网页授权域名 与站点域名不一致
- 小程序体验版用户未加入体验成员
处理
- 按 微信 文档从 Token 测试到区域开关逐项核对
支付成功但订单 / 余额未更新
可能原因
- 微信 / 支付宝 回调 URL 未配置或域名错误
- 商户 API 证书与平台公钥不匹配
- 反向代理缓存了 POST 请求
处理
- 核对回调地址：
- 微信：
https://你的域名/api/payment/wx-notify - 支付宝：
https://你的域名/api/payment/alipay-notify
- 微信：
- 查看 系统监控 → 系统状态 与 财务管理 → 资金交易
- 详见 支付与提现
用户收不到短信 / 推送 / 微信通知
可能原因
- 系统配置 → 腾讯云短信 未填或模板错误
- 通知控制台 → 事件模板 未勾选对应渠道
- App Push 需运维配置 FCM / APNs 环境变量，后台无 Tab
- 用户处于 静默时段 或未订阅小程序消息
处理
搜索不到新内容
可能原因
- Meilisearch 未启动或密钥不一致
- 索引尚未同步
处理
外卖 / 跑腿无入口或无人接单
可能原因
- 区域外卖配置 / 跑腿区域配置 未启用
- UI TabBar 未添加 Tab
- 骑手审核 通过人数不足或骑手未上线
处理
无法进入管理后台
可能原因
- 非 H5 环境（管理端仅浏览器 H5）
- 账号类型不是超级管理员 / 平台管理员 / 区域管理员
- 未登录或登录过期
处理
- 使用 Chrome 等浏览器打开
https://你的域名/pages_admin/index/index（不是文档站地址） - 确认账号类型；普通用户无后台入口
区域配置
| 问题 | 检查菜单 |
|---|---|
| 某区域功能与其他区域不一致 | 是否只改了「平台默认」未改该区域行 |
| 区域管理员看不到数据 | 系统设置 → 账号权限 中该账号的管辖区域是否包含目标区域 |
| 关闭某区域私信 | 区域列表 编辑区域 |
验证是否生效
解决任一问题后，用 最小复现路径 再测一次（如：单用户微信登录、单笔支付、单条搜索），并在对应监控 / 流水菜单确认记录正常。
常见问题（补充）
改了配置客户端仍旧样
- 客户端缓存：杀进程重进；UI 配置需匹配 同一区域
- 部分系统配置保存后立即生效，微信 Token 类需点「获取 Token」验证
找谁处理
| 类型 | 负责方 |
|---|---|
| 菜单、区域规则、活动配置 | 站点管理员 |
| 服务器、Docker、环境变量、备份 | 运维 |
| 授权模块开通 | 授权 / 商务 |