常见问题
按出现频率排的，先看前几条。
激活提示「该域名已绑定到其他授权」
一个域名全平台只能绑一个授权。要么换个域名，要么在站长中心把旧授权上的该域名解绑后再激活。 注意吊销授权不会自动解绑域名。
激活提示「授权版本不匹配」
插件要用 插件版（plugin）授权，独立版服务端要用 独立版（standalone）授权。 在站长中心领授权时选错了版本就会报这个，重新领一个对应版本的即可。
激活提示「无法确定本站域名」
插件按请求的 Host 推断域名。若站点在反向代理后面导致取不到，请在设置页的 site 分组里 把 publicBase 填成对外访问地址（如 https://www.yoursite.com），再激活。
插件设置页打不开 / 404
先确认插件已启用（不只是上传）。然后试试兼容写法：https://你的站点/index.php?s=/addons/ads/admin/index。 还不行就清一下 MacCMS 的缓存——插件的路由钩子有缓存，刚启用时可能还没生效。
页面提示「请先登录 MacCMS 后台」
插件设置页复用 MacCMS 的后台登录态。先登录站点后台，再在同一个浏览器里打开设置页。
打包一直排队不动
说明平台侧的打包机暂时没在线或正忙。打包机是我们这边维护的，稍等几分钟会自动领取； 长时间不动请联系平台管理员。
打包失败：图标相关报错
图标必须是正方形 PNG，建议 512×512，最小 192×192。过小或非正方形现在会在上传时就被拦下并提示。
APP 装不上 / 提示应用冲突
多半是签名证书不一致：同一个包名用了不同证书签名。请不要自行替换证书； 如果你换过包名，手机上要先卸载旧版再装新版。
新版本装不上去（无法覆盖升级）
检查版本号（versionCode）是否比已安装的那个大——相同或更小时系统会拒绝安装。 另外确认包名没变。
APP 里接口报签名无效（40101）
打包时注入的 APP_ID / APP_SECRET 必须和插件设置页里的一致。 如果你重装过插件导致凭据重新生成，需要用新凭据重新打包。联调阶段可以临时把security.signRequired 设为 false 关闭校验定位问题。
APP 里接口报请求已过期（40102）
服务器时间不对。签名允许 5 分钟时钟偏差，请校准服务器时间（NTP）。
APP 里不显示广告
依次检查：ads.enabled 是否为 true、kuadAppKey 是否填的正式 Key、 对应广告位 ID 是否为空、kuad 后台该广告位是否已启用。广告位 ID 是运行时下发的，改完重启 APP 即可，不用重新打包。
漫画模块看不到内容
漫画读的是 mac_manga 表，旧版 MacCMS 没有这张表。 没有该表时漫画模块会自动隐藏。
卸载插件会丢数据吗
「禁用」只停用，数据全保留。「卸载」会删除插件所有 前缀_app_* 表， APP 的用户、积分、订单、社区数据随之永久消失。请谨慎操作。