PHP环境数据库连接失败，1049错误提示phpEnv数据库不存在，怎么办？

本文共计923个文字，预计阅读时间需要4分钟。

错误最常出现在`.env`文件中，将`DB_DATABASE`写成了类似于`D:PHPDGAPIdatabase01.sql`的本地文件路径。MySQL的`database`参数只接受数据库名称（字符串），不是文件路径或SQL脚本。一旦这样写，PDO就会尝试连接一个不存在的数据库`D:PHPDGAPIdatabase01.sql`，因此会报错`SQLSTATE[HY000][1049] Unknown database 'D:PHPDGAPIdatabase01.sql'`。

正确做法是：

• DB_DATABASE 只填纯数据库名，比如 myapp、cardgame、laravel
• SQL 文件要手动导入：用 mysql -u root -p myapp 或 <a style="color:#f60; text-decoration:underline;" title="php" href="https://www.php.cn/zt/15714.html" target="_blank">php</a>MyAdmin 导入到已存在的库中
• 确保该库名已在 MySQL 中真实存在（执行 SHOW DATABASES; 可验证）

phpEnv 环境下必须确认 MySQL 服务已启动且库已创建

phpEnv 是集成环境，但它的 MySQL 不一定默认开机自启，也不自动建库。报 1049 时别急着改代码，先确认基础状态：

• 打开 phpEnv 控制面板，检查 MySQL 服务状态是否为「运行中」；若为「停止」，点启动
• 打开 phpEnv 自带的 phpMyAdmin（通常是 http://127.0.0.1/phpmyadmin），用 root 登录后看左侧数据库列表里有没有你写的 DB_DATABASE 名字
• 如果没有，点击「新建」→ 输入库名 → 字符集选 utf8mb4_unicode_ci → 创建
• 不要依赖 phpEnv 的「初始化数据库」按钮——它通常只建默认库（如 phpenv），不会读取你的 .env

Laravel 项目必须重载配置缓存

改完 .env 后直接跑 php artisan migrate 还是报 1049？大概率是 Laravel 缓存了旧配置。Laravel 5.5+ 默认启用配置缓存，.env 修改后不刷新就无效。

立即学习“PHP免费学习笔记（深入）”；

执行这两步（顺序不能错）：

• php artisan config:clear —— 清掉旧缓存
• php artisan config:cache —— 重新生成缓存（注意：生产环境才需要这步；开发时也可临时用 php artisan serve --no-reload 避免缓存干扰）
• 如果还连不上，顺手加一句 dd(env('DB_DATABASE')); 在路由或 config/database.php 里，确认读到的值确实是你要的库名，不是 forge 或空字符串

权限和连接上下文容易被忽略

即使库存在、名字对、服务在跑，仍可能因权限或连接方式失败：

• phpEnv 默认 MySQL 用户是 root，密码为空，但有些版本会设默认密码（如 root）。检查 phpEnv\MySQL\my.ini 或控制台登录提示
• 用命令行验证：在终端执行 mysql -h 127.0.0.1 -P 3306 -u root -p myapp，输密码后能进就是库+权限 OK；进不去就说明问题不在 Laravel，而在 MySQL 层
• Windows 下注意 DB_HOST=127.0.0.1 和 DB_HOST=localhost 行为不同：localhost 会走 socket，127.0.0.1 才走 TCP；phpEnv 多数情况认后者，建议统一用 127.0.0.1

实际出问题时，90% 是 DB_DATABASE 填了路径或拼写错，剩下 10% 是没建库 + 没清缓存。先盯住这两点，比调各种配置快得多。