帝国CMS常见问题解决

# 帝国CMS常见问题解决

使用帝国CMS建站过程中难免遇到各种问题，本文整理了最常见的故障排查和解决方法。

## 一、后台相关

**Q1：后台登录后空白页**
– 检查 `e/config/config.php` 中的 `ecms_config` 配置是否正确
– 确认 PHP 版本兼容（帝国CMS 7.5 推荐 PHP 7.x）
– 检查 `e/class` 目录文件是否完整

**Q2：后台验证码不显示**
– GD 库未安装：联系服务器商开启 GD 库
– `e/showkey/` 目录权限不足：设置 755 权限
– 临时解决方案：后台关闭验证码（不建议长期使用）

**Q3：忘记后台管理员密码**
– 通过数据库修改：在 `phome_enewsuser` 表中重置密码
– 或使用官方提供的密码重置工具

## 二、模板与栏目

**Q4：模板标签不生效**
– 检查标签语法是否正确，帝国CMS模板标签使用 `[!–标签–]` 格式
– 确认栏目模板已绑定到对应栏目
– 后台刷新模板缓存：系统 → 数据更新中心

**Q5：栏目页面404**
– 检查栏目的「生成选项」设置，确认栏目目录已生成
– 伪静态配置问题：检查 `.htaccess` 或 nginx rewrite 规则

**Q6：分页显示不正常**
– 检查列表模板中的分页标签 `[!–page.url–]` 是否正确
– 列表页每页显示数量设置是否合理

## 三、内容发布

**Q7：编辑器上传图片失败**
– 检查 `d/file/` 目录写入权限（设置为 755 或 777）
– 检查 PHP 的 `upload_max_filesize` 配置
– 确认编辑器配置中的上传路径正确

**Q8：发布文章后前台不显示**
– 后台刷新数据：系统 → 刷新所有内容页
– 检查文章审核状态是否为”已审核”
– 确认文章所属栏目已生成静态页

**Q9：内容页调用字段为空**
– 检查模型字段是否已启用
– 确认内容页模板中的字段标签名称与后台设置一致

## 四、性能与安全

**Q10：网站访问速度慢**
– 开启页面静态化（帝国CMS本身就是生成静态HTML的）
– 减少首页和列表页的动态调用
– 启用 Gzip 压缩
– 使用 CDN 加速静态资源

**Q11：频繁被黑客攻击**
– 修改默认后台路径（`e/admin`）
– 定期更新帝国CMS到最新版本
– 设置合理的后台访问权限
– 安装WAF防火墙

## 五、迁移相关

**Q12：换域名后图片不显示**
– 在后台系统设置中更新网站地址
– 数据库中批量替换旧域名为新域名（通过后台「批量替换字段值」功能）

**Q13：搬家后前台报错连接数据库失败**
– 修改 `e/config/config.php` 中的数据库连接信息
– 确认新服务器的 MySQL 用户有对应数据库的权限

## 六、SEO相关

**Q14：伪静态设置后URL报404**
– Apache 环境：检查 `.htaccess` 文件是否在网站根目录
– Nginx 环境：在配置文件中添加帝国CMS的 rewrite 规则

**Q15：百度收录量下降**
– 检查是否改版导致大量死链
– 在百度搜索资源平台提交改版规则或死链
– 确保站点地图正常生成并可访问