> 来源：https://mac-cms.com/cms/cms-faq
> 简介：MacCMS（苹果CMS）常见问题速查：数据库连接失败、除首页外全404伪静态、重装删install.lock、采集没数据、接口返回空、CORS跨域、忘记后台地址。详细排障见部署排障大全。
> 更新：2026-11-02

# MacCMS 常见问题

这里是速查版，一句话说清。每类问题的完整"症状 → 原因 → 解决"写在[部署排障大全](/cms/cms-troubleshooting)里，装站前后遇到报错优先翻那页。安全相关的看[安全加固](/cms/cms-security)。

## 安装相关

### 数据库连接失败

查 `/application/database.php`，确认 `hostname / database / username / password / hostport` 填对、数据库已创建。详见[排障](/cms/cms-troubleshooting#数据库连接失败)。

### 除首页外都是 404

伪静态没配。Nginx、Apache 两套规则见[排障](/cms/cms-troubleshooting#除首页外全部-404)。

### 如何重新安装

删掉安装锁文件 `/application/data/install/install.lock`，重新访问域名即可。

### PHP 8 下报类型错误

ThinkPHP5 和 PHP 8.x 不太合，建议换 PHP 7.x。见[排障](/cms/cms-troubleshooting#php-8-x-各种类型报错)。

## 采集相关

### 采集后没数据

多半是分类没绑定，或资源站本来就没这个分类的数据。排查步骤见[排障](/cms/cms-troubleshooting#采集之后没有数据)。采集流程本身看[采集教程](/cms/cms-collect)。

### 采集速度慢

首次全量采集慢是正常的，之后只采当天就快了，别在高峰期采。

## 接口相关

### 接口返回空数据

先确认库里有数据，再测 `/api.php/provide/vod/?ac=videolist`。见[排障](/cms/cms-troubleshooting#接口返回空数据)。

### 跨域（CORS）

App 取不到数据常是跨域没放开，服务器加 `Access-Control-Allow-Origin` 等头。见[排障](/cms/cms-troubleshooting#cors-跨域取不到数据)。

## 后台相关

### 后台打不开，提示"请将 admin.php 改名"

这是源码的强制要求，不是报错。`admin.php` 里写死了检查：只要还用 `admin.php` 访问后台就会被直接拦下、进不去。**必须把 `admin.php` 改成别人猜不到的文件名**（如 `admin7854.php`），再用新文件名访问。详见[排障](/cms/cms-troubleshooting#后台打不开-后台-404-提示-请将-admin-php-改名)。

### 忘记后台地址

改过名后，后台地址是"域名 + 你自己起的那个 `xxx.php`"，在网站根目录能找到这个文件。注意不能再用默认 `admin.php`——源码会强制拦截。

### 忘记管理员密码

从数据库直接改，或删 `install.lock` 重装。