Laravel数据库连接超时？如何查看并修改数据库连接配置【技巧】-php教程-PHP中文网

laravel无法控制数据库连接建立超时，仅能设置查询执行超时（pdo::attr_timeout）；需从环境配置、连接参数、查询行为三层排查，重点确认.env生效、mysql可达性及密码特殊字符处理。

laravel数据库连接超时？如何查看并修改数据库连接配置【技巧】

Laravel 本身不控制数据库连接建立阶段的超时，所谓“连接超时”不是 Laravel 配置能直接改的参数。真正卡住连不上（比如 `SQLSTATE[HY000] [2002] Connection timed out`）是操作系统 TCP 握手或 MySQL 服务端拒绝响应导致的，Laravel 只能干预连接成功后的查询执行阶段。要排查和优化，得从三层入手：**环境配置是否生效、连接参数是否正确、查询行为是否可控**。下面分几块说清楚。

确认当前用的是哪套数据库配置

别只改 config/database.php —— Laravel 优先读 .env 文件，里面的值会覆盖配置文件。改完 .env 后必须运行：

php artisan config:clear（清配置缓存）
再用 php artisan tinker 验证：

env('DB_HOST') 和 config('database.connections.mysql.host') 输出应该一致；如果不一致，说明缓存没清干净或 .env 格式有误（比如多了空格、中文、未闭合引号）。

检查 MySQL 服务与网络是否可达

报错 Connection refused 或 Connection timed out，90% 不是 Laravel 的问题，而是底层连不上：

本地开发：用 mysql -h 127.0.0.1 -P 3306 -u your_user -p 手动测试，别用 localhost（可能走 socket，而 DB_SOCKET 没配）
Docker 环境：DB_HOST 不能写 localhost，得填容器名（如 mysql）或宿主机网关 IP（如 172.17.0.1）
查 MySQL 是否监听对应端口：sudo netstat -tuln | grep :3306
用户权限要允许从当前 host 连接，例如 Laravel 在容器里连宿主 MySQL，用户得是 'user'@'%'，不是 'user'@'localhost'

修改查询执行超时（Laravel 唯一能控的“超时”）

Laravel 能设置的只有 PDO::ATTR_TIMEOUT，它控制的是单条 SQL 执行的最大秒数，不是连接建立时间。设太小会误杀慢但合法的查询（比如报表导出），设太大又掩盖性能问题。

在 config/database.php 的 mysql 连接配置里加：

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

'options' => [
    PDO::ATTR_TIMEOUT => 10,
],

搭配重试（Laravel 9+ 支持）可缓解瞬时抖动：

'retries' => 2,

注意：重试只在 query 失败后触发，首次 connect 失败不会重试。

密码含特殊字符？优先用 DB_URL 方式

如果 DB_PASSWORD 包含 @ / : ? 等字符，直接写进 .env 容易被 DSN 解析截断，导致 Access denied 错误。

方案一：URL 编码后填入，例如 p@ss/w?rd → p%40ss%2Fw%3Frd
方案二（更推荐）：改用 DB_URL，Laravel 9+ 原生支持，自动处理编码：

DB_URL=mysql://user:p%40ss%2Fw%3Frd@127.0.0.1:3306/dbname

这样既安全又免去手动编码麻烦。