← 返回错误码列表

MySQL错误码 1049 分析与解决方案

错误信息

Error 1049

未知数据库。检查数据库名是否正确。

你的PHP应用在使用PDO连接MySQL时遇到了数据库不存在的问题：

'pdo_code' => '1049',
'db_code' => 1049,
'db_error' => 'Unknown database \'database_name\''

解决方案

  • 检查数据库名称是否正确拼写
  • 确认数据库是否已创建
  • 检查数据库连接配置
  • 验证数据库用户权限
  • 检查MySQL服务器状态
  • 确认数据库字符集设置

PHP连接配置示例

// 正确的数据库连接配置
$host = 'localhost';
$dbname = 'your_database_name'; // 确保这个数据库存在
$username = 'your_username';
$password = 'your_password';

try {
  $pdo = new PDO(
    "mysql:host={$host};dbname={$dbname};charset=utf8mb4",
    $username,
    $password,
    [
      PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
      PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
    ]
  );
  echo "数据库连接成功！";
} catch (PDOException $e) {
  echo "连接失败: " . $e->getMessage();
}

连接过程演示

MySQL连接过程及错误1049的发生场景：

应用尝试连接

1. PHP应用使用PDO连接MySQL

2. 提供主机、用户名、密码和数据库名

MySQL服务器验证

1. 验证用户名和密码

2. 检查指定的数据库是否存在

错误发生

MySQL找不到指定的数据库

返回错误：1049

错误消息：Unknown database 'database_name'

排查步骤

1. 检查数据库是否存在

# 登录MySQL后执行
SHOW DATABASES;

2. 创建数据库（如果不存在）

# 创建新数据库
CREATE DATABASE your_database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. 检查用户权限

# 查看用户权限
SHOW GRANTS FOR 'your_username'@'localhost';

4. 授予数据库权限

# 授予用户对数据库的权限
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost';

预防措施

1. 开发环境

  • 使用版本控制管理数据库脚本
  • 创建数据库迁移脚本
  • 在部署脚本中包含数据库创建

2. 生产环境

  • 使用配置管理工具管理数据库配置
  • 实现健康检查机制
  • 设置数据库连接监控

3. 代码层面

  • 使用环境变量管理数据库配置
  • 实现连接重试机制
  • 添加详细的错误日志记录

调试工具

使用以下命令调试数据库连接问题：

# 检查MySQL服务状态
systemctl status mysql

# 测试MySQL连接
mysql -u your_username -p -h localhost

# 查看错误日志
tail -f /var/log/mysql/error.log

常见问题排查

数据库不存在：检查数据库名称拼写

权限不足：检查用户对数据库的权限

MySQL服务未启动：检查MySQL服务状态

网络问题：检查网络连接和防火墙设置