常见问题速查

部署

Q：首页显示的是旧版本内容 A：根目录还留着 index.html。服务器优先返回 .html，删掉它。

Q：连接数据库失败，但账号密码没错 A：宝塔默认只允许 localhost。把 DB_HOST 从 127.0.0.1 改成 localhost。

Q：页面 500 A：临时把 config.local.php 里的 APP_DEBUG 设为 true，刷新看具体报错，处理完改回 false。

Q：中文乱码 A：确认库、表、连接三处都是 utf8mb4。系统建表时已指定；若手工建表需自己带上。

内容编辑

Q：后台保存后前台没变 A：Ctrl + F5。内容是服务端渲染不缓存，但 CSS / JS 会。

Q：列表行的顺序怎么调 A：每行右侧有 ↑ ↓ 按钮。

Q：想加一个新模块 A：目前需要改代码（在 inc/seed.php 注册 + inc/render.php 加渲染函数）。表结构不用动。

采集

Q：采回来的文件是空的 A：先查登录态。接口返回登录页 HTML 时，解析会拿到空数据。

Q：排名数据有个别词缺失 A：可能是「未上榜」。未上榜记为空而不是 0，这是有意设计的。

分析

Q：为什么转化率和后台看到的不一样 A：系统按分子 ÷ 分母重算，不复用源表比率列。口径差异见「入库与口径重算规则」一章。

Q：补货建议量和手工算的差很多 A：先确认「加权日销」窗口和「目标周转天数」是不是同一套参数。