返回站点

打不开怎么办

按症状查：白屏、404、500、没样式、图片裂、发了看不到、改了不生效。每条给原因和修法。

约 5 分钟 上线 代码块右上角可一键复制
本页目录（5 分钟读完）
先看到真实错误 整页空白 404 500 搬家后打开不对 没样式 / 页面很丑 图片裂 发了看不到 改了不生效 提交表单 419 登不进后台 还是不行

Ctrl+F 搜你看到的症状（比如 404、没样式、保存后）。

先看到真实错误#

线上不显示报错是故意的。排错第一步：把错误调出来。

  1. 浏览器打开 http://你的域名/server_debug.php
  2. 它会临时打开调试，页面上直接写错误
  3. 修好后删掉这个文件（或改名）

看日志：

日志位置
程序日志runtime/log/
邮件日志runtime/log/mail/
服务器日志宝塔 → 网站 → 日志

整页空白#

原因怎么确认怎么修
模板写错了runtime/compile/ 里最新文件最后一行补 {/if}，改掉非法写法
PHP 报错被吞打开 server_debug.php按提示改
主题不存在后台 → 系统设置 → 模板切回 default
目录不可写ls -ld runtimechown -R www:www runtime

404#

你想打开404 原因怎么修
/admin没配伪静态加那条 try_files
/article/1.html同上同上
/list/xxx栏目 slug 不对后台 → 栏目，看「别名」
某篇文章没发布后台改成「已发布」

伪静态就这一条（宝塔 → 网站 → 伪静态）：

Nginx
location / {
    try_files $uri /index.php?$query_string;
}

500#

  1. 打开 server_debug.php 看真实错误
  2. 常见：插件冲突 → 后台关掉最后一个改的插件
  3. 常见：改坏了代码 → 用备份覆盖回去

搬家后打开不对#

症状原因怎么修
403「非法的访问域名」trusted_hosts 里漏了新域名把新域名加进白名单 → 搬家与换域名
报「表不存在」prefix 表前缀跟库里不一致改成库里实际的前缀
改了密码还是连不上库只改了 config/database.php要改 data/database.config.php
登不进、数据乱码data/secret.key 没带过来从旧服务器拷回来
清完缓存整页 500root 跑了 rebuild 没改属主chown -R www:www runtime

详细步骤 → 搬家与换域名。

没样式 / 页面很丑#

  1. 浏览器按 F12 → Network
  2. 刷新，看 style.css 是不是 403
  3. 是 403 → Nginx 把 /view/ 整个拒了

修法：让静态文件能访问。宝塔伪静态里加：

Nginx
location ~* \.(css|js|png|jpe?g|gif|webp|svg|woff2?)$ {
    try_files $uri =404;
}

图片裂#

原因怎么修
上传目录 403宝塔放行 /runtime/upload/
图片真不存在后台重新传一张
用了外链，外链挂了换成本地图片

发了看不到#

  1. 后台看状态是不是「已发布」
  2. 是「草稿」→ 点「发布」
  3. 刷新前台；还看不到 → 清缓存：
Shell
php aucms cache:clear

改了不生效#

按顺序试：

  1. 浏览器强制刷新（Ctrl+F5）
  2. php aucms cache:clear
  3. php aucms cache:rebuild
  4. 重启 PHP（宝塔 → 服务 → PHP → 重启）

提交表单 419#

  1. 刷新页面再提交
  2. 还不行 → 清浏览器 Cookie，重新登录

登不进后台#

症状修法
验证码总错点验证码图换一张
密码忘了php aucms user:password 你的账号
跳回登录换浏览器试，清 Cookie
打不开 /admin加伪静态那条 try_files

还是不行#

  1. 开 server_debug.php，把错误记下来
  2. 看 runtime/log/ 今天那个日志文件
  3. 用备份还原：数据库 + data/ + 代码
没找到答案？ 在后台「缓存与维护 → 系统体检」里看环境是否正常；仍无解就打开 server_debug.php 复现一次，页面会直接告诉你异常文件与行号。