海洋 CMS 安装提示数据库连接失败怎么处理

数据库连接失败，**九成以上是这四类原因之一：数据库地址填错、数据库/用户没建或没授权、账号密码不对、MySQL 版本与认证方式不兼容**。按「拿命令行验证一次 → 再看 CMS 报错原文」的顺序排查，通常 5 分钟内能定位到具体是哪一类。

海洋 CMS 提示数据库连接失败，先分清是哪种报错

**结论：报错原文里的关键词直接决定排查方向，先抄下完整错误信息再动手。**

常见的三种表述对应不同问题：

• 出现 Access denied for user 'xxx'@'localhost' —— 账号或密码错，或者该用户没有这个库的权限；
• 出现 Unknown database 'xxx' —— 数据库根本没建，或名字拼错（注意大小写，Linux 下库名是区分大小写的）；
• 出现 Can't connect to MySQL server / No such file or directory —— 地址、端口或 socket 路径不对，跟账号密码无关。

安装时通常需要填：数据库地址、端口（默认 3306）、数据库名、用户名、密码、表前缀。任何一项和前面对不上，都会在这一步卡住。

怎么快速验证数据库账号能不能连？

**结论：不要依赖安装界面提示，自己写一个三行的测试文件，报错信息比 CMS 的提示详细得多。**

在网站根目录建 test.php：

<?php
$conn = mysqli_connect('127.0.0.1','你的用户名','你的密码','你的库名',3306);
if(!$conn){ die('连接失败: '.mysqli_connect_error()); }
echo '连接成功';

浏览器访问 http://你的域名/test.php。连上了说明账号密码库名都没问题，问题在 CMS 的填写或 PHP 扩展；连不上，报错原文就是答案。

如果服务器有 SSH，更直接：

mysql -h 127.0.0.1 -P 3306 -u 用户名 -p

能进到 mysql> 提示符，说明账号可用。再看权限：

SHOW GRANTS FOR '用户名'@'localhost';

没看到对应库的权限就补授权：

GRANT ALL PRIVILEGES ON 库名.* TO '用户名'@'localhost';
FLUSH PRIVILEGES;

另外确认 PHP 装了 mysqli 扩展：php -m | grep -i mysqli，没有输出就在面板里勾选安装。

地址填 localhost 还是 127.0.0.1？

结论：优先填 127.0.0.1，它比 localhost 少一个 socket 路径的坑。

MySQL 里 localhost 走的是 Unix socket 连接，默认路径 /tmp/mysql.sock；PHP 的 mysql.default_socket 或 pdo_mysql.default_socket 如果指向了别的路径（宝塔面板下常在 /www/server/mysql/mysql.sock），就会出现 No such file or directory。而 127.0.0.1 走的是标准 TCP 3306 端口，路径问题不存在。反过来，如果你的 MySQL 没开 TCP 监听，那只能走 socket，这时要看 ss -lntp | grep 3306 有没有监听。

MySQL 8.0 上安装海洋 CMS 报连接失败怎么办？

**结论：MySQL 8.0 默认认证插件是 caching_sha2_password，老版本 PHP 和部分 CMS 安装程序不支持，改成 mysql_native_password 即可。**

在 MySQL 里执行：

ALTER USER '用户名'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';
FLUSH PRIVILEGES;

同理，PHP 8.x 搭配较老版本的 CMS 也可能因为函数弃用报错，如果条件允许，用 PHP 7.0～7.4 兼容性更稳。这不是玄学，是认证插件和语言版本的兼容性问题，改完立刻生效。

云服务器和宝塔面板下还要检查什么？

**结论：同机部署时，数据库不要开放到公网，用 127.0.0.1 就够了；只有数据库在另一台机器上时才需要处理白名单和端口。**

三种情况要分清：

1. 数据库和网站同一台服务器：填 127.0.0.1，不需要在安全组放行 3306，也不需要对外开放，安全性最好；
2. 数据库是云数据库（如 RDS）：必须在控制台把网站服务器的公网/内网 IP 加进白名单，否则永远连不上；
3. 数据库在另一台自建服务器：除了目标机放行 3306，还要确认 MySQL 配置里 bind-address 不是只监听 127.0.0.1。

最后提醒一句：安装完成后把 install 目录改名或删掉，避免被人重新执行安装流程覆盖数据库配置。密码里带 #、@、$ 这类特殊字符时，在命令行下要用单引号包起来，在安装界面里原样输入即可，不要自作主张转义。