首先检查数据库配置文件中的连接参数是否正确，包括主机、数据库名、用户名、密码和端口；随后确认数据库服务是否运行，可通过系统命令或服务管理器启动MySQL服务；接着验证数据库账户权限，确保用户可以从当前主机登录并拥有相应数据库的访问权限；然后检查PHP代码中使用的数据库连接方式，避免使用已弃用的mysql_connect函数，建议改用mysqli或PDO扩展；最后排查防火墙和网络策略，确保数据库端口开放且允许客户端IP连接，特别是在远程或云服务器环境下。
如果您尝试运行PHP源码成品但无法与数据库建立连接，可能是由于配置文件中的数据库连接参数错误或数据库服务未正常启动。以下是解决此问题的步骤：
一、检查数据库配置文件
大多数PHP源码成品会将数据库连接信息存储在单独的配置文件中，如 config.php 或 database.php。需要确认该文件中填写的连接参数是否与实际数据库环境一致。
1、找到项目根目录下的数据库配置文件，常见路径为 /config/config.php 或 /application/database.php。
2、打开文件后查找以下关键字段：主机地址（host）、数据库名（database）、用户名（username）、密码（password）和端口（port）。
立即学习“PHP免费学习笔记（深入）”；
3、核对这些值是否与您的数据库服务器设置完全匹配，例如本地开发环境通常使用 localhost 作为主机地址，端口为 3306。
二、验证数据库服务状态
确保MySQL或MariaDB等数据库服务正在运行，否则即使配置正确也无法建立连接。
1、在服务器终端执行命令 systemctl status mysql（Linux系统）查看服务运行状态。
2、如果服务未启动，则运行 sudo systemctl start mysql 启动数据库服务。
3、对于Windows环境，请打开“服务”管理器，查找 MySQL 服务并确认其状态为“正在运行”。
三、测试数据库账户权限
某些情况下，虽然用户名和密码正确，但账户可能没有从当前主机访问指定数据库的权限。
1、登录数据库管理界面，例如通过命令行执行 mysql -u root -p 进入MySQL控制台。
2、执行 SQL 查询：SELECT Host,User FROM mysql.user WHERE User='your_username'; 确认该用户允许从当前连接主机（如 localhost 或 %）登录。
3、若权限不足，可使用 GRANT 命令授予权限，例如：GRANT ALL PRIVILEGES ON your_database.* TO 'your_username'@'%'; 并执行 FLUSH PRIVILEGES 刷新权限。
四、修改连接方式为持久连接或调整驱动
部分老旧PHP源码使用已弃用的 mysql_connect 函数，而在PHP 7及以上版本中已被移除，需改用 mysqli 或 PDO 方式连接。
1、检查代码中是否存在 mysql_connect() 调用，若有则应替换为 mysqli_connect() 或使用PDO实例化。
2、使用 mysqli 的示例语句：$conn = mysqli_connect("localhost", "user", "pass", "database");
3、启用错误报告以获取详细连接失败原因，在连接语句前添加：mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
五、检查防火墙与网络策略
当数据库位于远程服务器时，网络限制可能导致连接超时或被拒绝。
1、确认目标数据库服务器的防火墙规则是否放行了数据库端口（默认3306），可通过 telnet host 3306 测试连通性。
2、在云服务器环境下，还需检查安全组策略是否允许来自客户端IP的入站连接请求。
3、若使用虚拟主机或共享主机，联系服务商确认是否允许外部数据库连接或是否有连接数限制。
