织梦CMS数据库连接文件找不到？_权限与隐藏文件显示技巧_安全加固
这个问题在运维中很常见，搞清楚原理就不难解决。
做网站运维这些年，这类问题被问过无数次。很多站长遇到报错就慌，其实每条错误都有固定套路可查。本文按实际经验把问题拆开，从原因到解决一步步讲清楚，看完照着操作就能处理大部分故障。
织梦CMS数据库连接文件的位置和作用。织梦CMS（DedeCMS）的数据库连接信息保存在网站根目录的data目录下，文件名叫common.inc.php，完整路径是：网站根目录/data/common.inc.php。这个文件就是织梦CMS的数据库配置文件，保存了连接数据库需要的全部参数。用FTP工具或服务器文件管理器，进入网站根目录，找到data文件夹，打开data文件夹就能看到common.inc.php。common.inc.php文件里的核心配置项：$cfg_dbhost——数据库主机地址，本机安装填localhost，数据库在其他服务器填IP或域名；$cfg_dbname——数据库名称，连接的是哪个库；$cfg_dbuser——数据库用户名；$cfg_dbpwd——数据库密码；$cfg_dbprefix——数据表前缀，默认dede_；$cfg_db_language——数据库语言，默认utf8。这五项是数据库连接的核心，搬家、换数据库、改密码都要改这个文件。修改方法：用FTP下载data/common.inc.php到本地，用代码编辑器（VS Code、Notepad++，不要用记事本）打开，修改对应的配置项值，保存，上传覆盖原文件。或者用宝塔面板的文件管理器直接编辑，保存即生效。修改后不用重启任何服务，刷新网站就按新配置连接数据库。找不到common.inc.php的情况：情况一，data目录不存在——织梦CMS必须要有data目录，如果被删了或没上传，网站会报错，重新上传data目录（完整目录包含common.inc.php、admin目录、cache目录等）。情况二，文件被隐藏——某些FTP工具默认不显示隐藏文件，common.inc.php不是隐藏文件，但确认FTP是否显示了所有文件（FileZilla勾选强制显示隐藏文件）。情况三，权限问题——data目录权限不够，文件读取失败，确认data目录权限755或可读，属主是Web用户。修改配置文件后网站打不开的排查：检查改的参数是否写错（库名、用户名、密码任何一个错都连不上），检查数据库是否真的存在且数据完整，检查表前缀是否和数据库实际表前缀一致。做过一次就能记住，下次直接照着处理。注意备份：修改data/common.inc.php前先备份原文件，改动出错能快速还原。安全注意：common.inc.php里有数据库密码，属敏感文件，权限尽量收紧（644），不要让外部直接访问。织梦CMS根目录还有data目录下的其他文件，但数据库连接文件就是common.inc.php这一个，认准它。搬家时数据库配置文件跟着网站文件一起迁移，新服务器上传完整目录后，修改common.inc.php里的数据库参数即可。常见误区：误区一，以为数据库配置在install或config目录——织梦CMS的数据库配置不在install，install是安装目录，配置在data/common.inc.php。误区二，以为改配置文件后要重启服务器——不用重启，刷新网站就生效，改了没生效是缓存或改错了文件。误区三，密码里有特殊字符——如果数据库密码含特殊符号（#、$、引号），在PHP文件里要注意，单引号包裹的字符串里出现单引号要转义，改完测试连接。织梦CMS数据库连接文件位置固定，就是data目录下的common.inc.php，掌握它的配置项含义和修改方法，数据库连接相关问题都能处理。
处理网站故障要养成记录的习惯，把每次出错的提示、解决过程记下来，下次同类问题直接套用。配合监控工具提前发现问题，别等用户反馈才处理。服务器权限、配置文件、数据库这三块是网站命脉，改动前一律备份。
更新时间：2026-08-26 18:27:41