常见问题
先做这一件事
出任何问题，先看网站根目录的 runtime.log。
注意是根目录那个 runtime.log，不是 runtime/log/ 里的。绝大多数问题的真实原因都写在里面。
DEBUG=false时，任何未捕获的异常都会被渲染成 404 页面并返回 HTTP 500 —— 页面上什么线索都没有，真实原因只在runtime.log里。
安装与访问
只有首页能打开，点任何链接都是 404 伪静态没配。见 伪静态规则。
白屏 / 500 多半缺 bcmath 扩展。所有金额计算都靠它，缺了直接致命错误。装法见 安装总览。
安装向导提示目录不可写config、runtime、kernel/Install、assets/cache 四个目录要可写。宝塔用户把网站目录所有者设为 www。
Docker 容器起来了但浏览器打不开 端口映射写反了。-p 8080:80 左边是宿主机端口，右边固定是 80。云服务器还要在安全组里放行端口。
Docker 升级后数据没了 当初没加 -v acg_data:/data。见 Docker 安装。
搬家之后
网站搬家后不能用，按顺序查：
config/database.php里的数据库连接信息是不是还是旧的- 旧站如果用过 Redis 存会话，新服务器也要装，或者把 PHP 的 session 存储改回文件
- PHP 扩展装齐没有（尤其
bcmath） - 目录权限、伪静态要重新配
详见 升级与迁移。
订单与支付
买家付了钱没收到货
- 后台 商品订单 里按订单号或联系方式搜，确认单子在
- 看状态：还是「未支付」说明支付回调没回来
- 回调回不来的常见原因：支付平台配的回调地址不对、CDN 防火墙把回调拦了
- CDN 导致的用自定义支付回调域名解决，见 网站设置
库存明明有，前台显示无货 商品配了种类或 SKU 时，库存是按规格分别统计的。某个规格没卡密，那个规格就买不了。也可能是卡密被锁定了。见 卡密管理。
买家选了年卡，发出来是月卡 导入卡密时没选对种类。
商品显示 0 元 会员价留空时，登录用户可能按 0 元买走。定价时把会员价一起填上。见 支付设置。
分站
子域名打不开 三件事缺一不可：后台配了主站域名和 DNS-CNAME、域名服务商加了 * 泛解析、服务器上绑定了 *.你的域名。最后一条最容易漏。
独立域名打不开 服务器没设默认站点。见 分站模块。
店铺共享
添加店铺失败 地址、商户 ID 或密钥不对，或者对方站点没开共享。
客户下单报错、发不出货 你在上游的余额不够。共享下单是拿你在上游的余额进货的。
商品列表拉不到 对方的商品没开「API 对接」开关。
插件与主题
插件装了没反应 装完要到 通用插件 里启用。
插件加了新的 Hook 文件不生效 钩子注册表是编译缓存，需要把插件停用再启用一次才会重建。
换主题后显示不正常 清模板缓存：删除 runtime/view/compile 目录下的内容。
不要删
runtime/config，那是配置缓存，删了整站会出问题。
提问的正确姿势
没有人能通过三言两语判断你遇到了什么问题。提问前先准备好：
runtime.log的内容 —— 出问题后网站根目录会有，下载下来打开- 前因后果 —— 你做了什么操作之后才出现的
- 截图 —— 只要和问题相关的都带上
准备齐了再问，才是最省时间的做法。三言两语描述问题当然也可以，总会有热心网友帮你，但那绝不会让你更快 —— 只会来回问上半天。
去哪问
- Telegram：https://t.me/mcyofficial