PHP项目本地正常，线上服务器无法读写数据库求助

一、优先排查线上数据库权限与配置 #

1. 数据库用户主机权限
   本地数据库用户通常允许localhost访问，但线上服务器（尤其是虚拟主机）可能要求数据库用户绑定特定IP或允许%（任意主机）访问。登录线上数据库管理面板（如phpMyAdmin），检查你的数据库用户tcorfns**_bams**的主机权限，确保Web服务器能正常连接。
2. 核对数据库信息
   仔细确认线上的数据库用户名、密码、库名与代码中的配置完全一致，注意部分主机区分数据库名、表名的大小写。同时确认线上已创建tcorfns**_bams**数据库，且表结构与本地完全同步。
3. 测试数据库连接
   在服务器上创建一个简单的测试脚本，直接测试PDO连接，获取具体错误信息：

   <?php
   try {
       $db = new PDO("mysql:host=localhost;dbname=tcorfns**_bams**", "tcorfns**_bams**", "Offs**");
       echo "连接成功";
   } catch(PDOException $e) {
       echo "连接失败: " . $e->getMessage();
   }
   ?>
   

二、优化数据库连接的错误处理 #

当前的Database类错误信息仅在页面输出，线上环境通常关闭错误显示，导致无法定位问题。修改连接代码，开启PDO异常模式并记录错误日志：

class Database {
    public function connect() {
        try {
            $dbhost = "localhost"; // 若测试失败，尝试主机提供的专属数据库地址（如db.yourdomain.com）
            $dbuser = "tcorfns**_bams**";
            $dbname = "tcorfns**_bams**";
            $dbpass = "Offs**";

            $options = [
                PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // 开启异常模式
                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
                PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4" // 统一字符集
            ];
            $db = new PDO("mysql:host=$dbhost;dbname=$dbname;charset=utf8mb4", $dbuser, $dbpass, $options);

            return $db;
        } catch(PDOException $err) {
            error_log("数据库连接错误: " . $err->getMessage()); // 写入服务器日志
            return null; // 返回null便于上层判断
        }
    }
}

三、修复注册功能的调试与潜在问题 #

1. 添加执行错误日志
   在注册的execute后添加错误信息捕获，定位插入失败原因：

   $proceed = $query->execute($values);
   if($proceed) {
       $msg = "注册成功，请查收邮箱验证信息";
       return $msg;
   } else {
       $errorInfo = $query->errorInfo();
       error_log("注册插入错误: " . $errorInfo[2]);
       $msg = "注册失败，请稍后重试"; // 线上用通用提示，开发环境可返回$errorInfo[2]
       return $msg;
   }
   

2. 检查表结构兼容性
   确认线上Users表的字段fname, lname, email, phone, state, password, ref_code存在，且字段类型、长度与本地一致（例如phone字段是否为字符串类型，避免长度不足导致插入失败）。

四、修复登录功能的SQL注入漏洞与逻辑问题 #

当前登录代码直接拼接$email到SQL语句，存在严重注入风险，且可能因字符集问题导致查询失败，修改为预处理语句：

public function login($data) {
    $email = $data['email'];
    $password = $data['password'];

    if(empty($email) || empty($password)) {
        $msg = "必须输入邮箱和密码";
        return $msg; 
    }
    
    if(!$this->checkUser($email)) {
        $msg = "该邮箱未注册";
        return $msg;
    } else {
        // 使用预处理语句避免注入
        $query = $this->db->prepare("SELECT email, password FROM Users WHERE `email` = ?");
        $proceed = $query->execute([$email]);
        $row = $query->fetch();

        if($proceed && $row) {
            if(password_verify($password, $row['password'])) {
                $_SESSION['connected'] = $email;
                header("Location: ../dashboard/");
                exit; // 跳转后必须终止代码执行
            } else {
                $msg = "邮箱或密码错误";
                return $msg;
            }
        } else {
            $errorInfo = $query->errorInfo();
            error_log("登录查询错误: " . $errorInfo[2]);
            $msg = "登录失败，请重试";
            return $msg;
        }
    }
}

五、检查线上服务器PHP配置 #

1. 确认PHP已启用PDO扩展：通过phpinfo()查看，若未启用需联系主机商开启。
2. 核对PHP版本：确保线上PHP版本与本地一致，避免语法兼容问题。
3. 查看服务器错误日志：线上环境关闭display_errors后，错误信息会写入服务器日志（如Apache的error.log、Nginx的error.log），从中提取具体报错信息。

六、网络与防火墙排查 #

确认线上服务器防火墙允许PHP连接数据库端口（默认3306），若数据库为远程主机，需确认Web服务器IP已被加入数据库白名单。

内容的提问来源于stack exchange，提问作者Kwikseller Technologies