XAMPP部署DedeCMS最常卡在404、数据库连不上、安装页不跳转、后台登录失败四类问题，根源几乎都出在路径配置、PHP版本兼容性或install目录残留上，不是程序本身坏了。
直接说结论：XAMPP 部署 DedeCMS 最常卡在 404、数据库连不上、安装页不跳转、后台登录失败这四类问题，根源几乎都出在路径配置、PHP 版本兼容性或 install 目录残留上，不是程序本身坏了。
为什么访问 http://localhost/dedecms 总是 404？
这不是 Apache 没启动，而是 DedeCMS 的「安装目录」参数和实际 URL 路径不一致。比如你把源码放进了 D:\xampp\htdocs\dedecms，但后台「系统基本参数 → 核心设置」里填了 dedecms，而浏览器访问的是 http://localhost/（没带子目录），DedeCMS 就会按 {cmspath}/a/xxx.html 拼链接，结果生成的 HTML 文件却在根目录下，自然 404。
解决方法：
- 安装时「网站网址」和「DedeCMS 安装目录」两项都留空（或填
/），不要手动输dedecms - 如果已安装完，进 phpMyAdmin 找
dede_sysconfig表，查varname = 'cfg_cmspath'这条记录，把value改成/ - 删掉
data/cache下所有文件，再重新生成栏目 HTML
安装页不自动跳转到 /install/index.php 怎么办？
常见于 XAMPP 启动后直接访问 http://localhost/ 却只看到 Apache 欢迎页，或者页面空白。本质是 index.php 没被识别为默认首页，或 .htaccess 重写失效。
检查点：
- 确认
D:\xampp\htdocs\dedecms（或你放源码的目录）里确实有index.php，且不是空文件 - 打开
D:\xampp\apache\conf\httpd.conf，搜索DirectoryIndex，确保这一行包含index.php，例如：DirectoryIndex index.php index.html - 如果用了伪静态，检查
AllowOverride All是否在对应<directory></directory>块里启用 - 临时绕过：手动访问
http://localhost/dedecms/install/index.php
MySQL 连接失败或安装时提示“无法连接数据库”
XAMPP 默认 root 密码为空，但 DedeCMS 安装向导有时会强制要求填密码；另外 PHP 7.4+ 和 DedeCMS V5.7 存在兼容问题，mysql_connect() 已被废弃，会导致连接报错。
必须做的三件事：
- 用 phpMyAdmin 登录（
http://localhost/phpmyadmin），在「用户账户」里确认root@localhost的密码是空的；如果不是，重置为无密码 - 打开
D:\xampp\php\php.ini，搜索extension=php_mysql.dll和extension=php_mysqli.dll，取消后者前面的分号（mysqli是必须启用的） - 在 XAMPP 控制面板里，把 PHP 切换为 5.6 或 7.0 —— DedeCMS V5.7 在 PHP 7.2+ 上大概率出现白屏或数据库函数报错
安装完后台能进，但登录后一片空白或跳转到 install 页面
典型症状是输入账号密码后页面刷新一下又回到登录页，或者显示空白。90% 是 data/common.inc.php 权限或内容被破坏，或是 install 目录没删干净。
排查顺序：
- 立刻删除
install文件夹 —— 不删它，DedeCMS 每次都会检测并强制跳回安装流程 - 检查
data/common.inc.php文件是否存在，是否被写入了数据库配置；如果为空或只有注释，说明安装中途失败，需清空数据库重装 - Windows 下右键该文件 → 属性 → 安全 → 编辑 → 给
IIS_IUSRS或Users组添加「读取和执行」「写入」权限（XAMPP 用的是 Apache，实际取决于你的服务运行用户） - 如果改过后台目录名（比如把
dede改成admin），要同步检查data/config.cache.inc里是否有旧路径缓存，删掉重生成
最易被忽略的一点：DedeCMS 的模板路径、JS/CSS 引用全部依赖 {dede:global.cfg_templets_skin/} 这类标签解析，一旦 data/common.inc.php 里 $cfg_templets_skin 值为空或错写成绝对路径，前台就会大量 404 —— 但它不会报错，只会静默失败。遇到样式丢失、图片不显示，先盯住这个变量。
