罗罗编程学习记录
本页内容 展开查看

06.5.5.6 DB 与 ORM 连接池

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.5 Hyperf

06.5.5.6-001 常驻内存模型为什么必须使用数据库连接池?

一句话结论

常驻进程不能像 FPM 那样每请求新建连接再销毁;连接池预先建立并复用数据库连接,按协程借用归还,避免频繁建连开销,同时控制并发连接数不超过数据库承载。

概念解释

无池化时每个协程自建连接,高并发下连接数暴涨、握手开销大;连接池维护最小/最大连接数,协程用完归还而非关闭。连接池是常驻框架对接数据库的标准组件。

原理流程

  1. 启动期按 min_connections 预热基础连接。
  2. 协程需要数据库时从池内取空闲连接。
  3. 用完归还连接,等待下一次借用。
  4. 空闲超时与心跳由池管理,失效连接被回收重建。

代码或图示

use Hyperf\DbConnection\Db;

$rows = Db::connection('default')->select('SELECT id, title FROM orders WHERE status = ?', [1]);

常见误区

  • 以为协程内每次查询自动新建连接:池化复用同一连接,借用期间不可被其他协程占用。
  • 把连接对象长期缓存到单例:连接应由池按借用周期分配,缓存持有会导致重复占用。

追问

  • 连接池解决了哪些 FPM 没有的问题?答:常驻进程复用连接、控制总连接数、管理空闲回收与心跳;FPM 短连接由进程生命周期自然释放。
  • 不用连接池会怎样?答:高并发下建连 CPU 与数据库连接数压力上升,连接泄漏风险更高。

06.5.5.6-002 databases.php 的配置结构是什么?

一句话结论

配置按连接名分组,每组包含主机、端口、数据库、账号、字符集与 pool 连接池段;默认连接名为 default,可定义多个连接对应不同库或读写分离。

概念解释

连接参数通过 env() 从环境变量读取,池参数独立在 pool 键下。多连接场景:业务库、报表库、只读库分别命名,代码按连接名获取。

原理流程

  1. 文件返回连接名 => 配置数组。
  2. 每组读取环境变量填充连接参数。
  3. pool 段定义连接数与超时回收策略。
  4. 启动期对应连接池按配置初始化。

代码或图示

// config/autoload/databases.php 片段
return [
    'default' => [
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => (int) env('DB_PORT', 3306),
        'database' => env('DB_DATABASE', 'hyperf'),
        'username' => env('DB_USERNAME', 'root'),
        'password' => env('DB_PASSWORD', ''),
        'charset' => 'utf8mb4',
        'pool' => [
            'min_connections' => 1,
            'max_connections' => 10,
        ],
    ],
];

常见误区

  • 把池参数写在连接段外层:池配置必须位于 pool 键内,否则不生效。
  • 生产配置提交真实密码:密码走环境变量注入,仓库只留默认值。

追问

  • 如何切换到其他数据库连接?答:Db::connection('report') 按名获取;模型可声明 $connection 属性指定默认连接。
  • 配置合并顺序?答:组件默认配置与项目配置合并;覆盖关系以框架配置机制为准(待确认)。

06.5.5.6-003 连接池各配置项分别控制什么?

一句话结论

min_connections 保底空闲连接,max_connections 连接上限,connect_timeout 建连超时,wait_timeout 借连接等待超时,heartbeat 心跳间隔,max_idle_time 空闲回收时长。

概念解释

最小连接保证低峰即取即用;最大连接保护数据库。等待超时防止协程无限排队;心跳与空闲回收避免拿到被服务端关闭的死连接。具体默认值以组件版本为准。

原理流程

  1. 池内空闲连接数低于最小值时补建。
  2. 借用时无空闲且未达上限则新建,达上限则排队等待。
  3. 等待超过 wait_timeout 抛出获取连接异常。
  4. 后台按心跳检测与空闲时间回收失效/闲置连接。

代码或图示

'pool' => [
    'min_connections' => 2,
    'max_connections' => 20,
    'connect_timeout' => 10.0,
    'wait_timeout' => 3.0,
    'heartbeat' => -1,
    'max_idle_time' => 60.0,
],

常见误区

  • max_connections 盲目调大:数据库实例连接数有上限,应用池总和不能超过数据库承载力。
  • max_idle_time 大于数据库 wait_timeout:空闲连接被服务端先关闭,下次借用拿到死连接。

追问

  • heartbeat 为 -1 表示什么?答:关闭主动心跳;具体取值语义以组件实现为准(待确认),生产建议结合数据库空闲超时设置探测间隔。
  • 连接数怎么估算?答:按 Worker 数 × 单 Worker 并发借用峰值,再留余量;并对照数据库 max_connections 分配。

06.5.5.6-004 连接的获取与归还流程是怎样的?

一句话结论

协程从池内借用空闲连接执行 SQL,执行结束连接归还池内;事务期间连接被当前协程独占,事务提交/回滚后才归还,期间其他协程不能使用该连接。

概念解释

连接借用与归还由 DB 组件在查询/事务边界自动完成。业务代码一般不手动取还连接;显式持有连接时必须确保异常路径也归还,避免连接泄漏。

原理流程

  1. 协程发起查询,组件从池取连接。
  2. 连接标记为占用,执行 SQL。
  3. 查询完成(或事务结束)连接归还空闲队列。
  4. 池内按空闲策略维护连接集合。

代码或图示

// 普通查询:组件自动借还
Db::table('orders')->where('status', 1)->get();

// 事务:连接在事务期间独占
Db::beginTransaction();
try {
    Db::table('orders')->where('id', 1)->update(['status' => 2]);
    Db::commit();
} catch (\Throwable $e) {
    Db::rollBack();
    throw $e;
}

常见误区

  • 事务内跨协程共享同一连接:连接被独占,其他协程借用会排队或超时。
  • 异常路径忘记回滚:连接长期占用不归还,池逐渐耗尽。

追问

  • 怎么确认连接已归还?答:观察池空闲/占用指标;异常未回滚导致占用不释放是常见泄漏点。
  • 长事务对池的影响?答:事务越长连接占用越久,并发峰值下池更容易耗尽,应缩短事务边界。

06.5.5.6-005 协程安全上为什么同一连接不能被两个协程同时使用?

一句话结论

数据库连接是有状态资源,一次只能服务一个会话;两个协程并发在同一连接上发 SQL 会导致语句交叉、结果错乱,因此池化连接按协程独占借用,用完归还。

概念解释

连接内有事务状态、预处理语句、结果集游标等会话上下文。共享连接在协程切换时互相打断,出现数据错位、事务串扰。连接池的隔离粒度就是“一次借用一个协程”。

原理流程

  1. 连接被协程 A 借用,标记占用。
  2. 协程 B 需要连接时取其他空闲连接,等待 A 归还。
  3. A 执行完归还,连接进入空闲队列。
  4. 下一个协程再借用同一连接。

代码或图示

// 正确:各自从池获取连接,不共享句柄
$orders = Db::connection('default')->table('orders')->get();
$users = Db::connection('default')->table('users')->get();

常见误区

  • 把 DB 连接对象存入静态变量供多协程取用:破坏独占约定。
  • 在静态缓存里保存查询结果集游标:结果集与连接绑定,连接归还后不可继续遍历。

追问

  • 协程化 MySQL 客户端本身线程安全吗?答:客户端连接实例按会话使用;安全前提是连接独占借用,而非多个协程共用一个实例。
  • 批量查询怎么避免长占连接?答:分批读取、及时释放结果集,不要把大结果集挂在内存中等候处理。

06.5.5.6-006 事务边界如何控制?

一句话结论

通过 beginTransaction()、commit()、rollBack() 显式划定事务边界;业务异常必须回滚后重抛,保证连接归还与数据一致性,事务范围只包含必要的写操作。

概念解释

事务绑定在借用连接上,提交或回滚后连接归还。事务内不要混入远程 RPC、发消息等长耗时操作,避免连接长时间占用与事务膨胀。

原理流程

  1. 开启事务,连接进入独占状态。
  2. 执行一组写操作与一致性校验。
  3. 全部成功提交;任一异常回滚。
  4. 连接归还池,异常向上传递。

代码或图示

Db::beginTransaction();
try {
    Db::table('account')->where('id', $from)->decrement('balance', $amount);
    Db::table('account')->where('id', $to)->increment('balance', $amount);
    Db::commit();
} catch (\Throwable $e) {
    Db::rollBack();
    throw $e;
}

常见误区

  • 事务内调用外部 HTTP/RPC:下游超时拖住数据库连接,还可能出现本地事务已提交而外部失败的不一致。
  • 回滚后不重抛:上层误以为成功,数据与状态不一致。

追问

  • 嵌套事务怎么处理?答:数据库事务本身不真正嵌套;框架可能用事务计数模拟,嵌套语义与保存点行为以组件实现为准(待确认)。
  • 只读查询需要事务吗?答:单条一致性查询通常不需要;需要重复读一致快照时再显式开启。

06.5.5.6-007 事务在协程中如何保证隔离?

一句话结论

事务期间连接独占当前协程,其他协程拿不到该连接,事务语句与会话状态不会交叉;不同协程的事务在各自连接上独立提交/回滚,隔离级别由数据库配置决定。

概念解释

协程隔离靠连接独占,隔离级别(读已提交、可重复读等)由数据库服务端控制。框架不改变数据库隔离语义,只保证连接不被并发借用。

原理流程

  1. 协程开启事务,连接标记事务中。
  2. 该连接不进入空闲队列,其他协程无法借用。
  3. 事务语句在独立会话内执行。
  4. 提交/回滚后连接归还,事务结束。

代码或图示

// 两个协程各自事务,连接互不干扰
go(function () {
    Db::beginTransaction();
    // 协程 A 事务
    Db::commit();
});
go(function () {
    Db::beginTransaction();
    // 协程 B 事务
    Db::rollBack();
});

常见误区

  • 以为协程隔离等同于数据库隔离级别:前者防连接交叉,后者防并发读写可见性,两者不同。
  • 跨协程传递事务连接:事务状态随连接走,传递句柄会破坏独占。

追问

  • 隔离级别在哪里配置?答:数据库实例与连接参数;Hyperf 不替代服务端隔离策略,具体级别以 MySQL 配置与业务需要为准。
  • 脏读/幻读怎么应对?答:按业务选择隔离级别并配合唯一约束、乐观锁;框架层不提供额外隔离保证。

06.5.5.6-008 #[Transactional] 注解如何使用?

一句话结论

在服务方法上标注事务注解,框架通过 AOP 代理在方法前后自动开启与提交事务,异常时回滚;注解简化声明式事务,但事务边界仍以方法为粒度。

概念解释

注解命名空间为 Hyperf\DbConnection\Annotation\Transactional。底层依赖 AOP 代理,被标注类必须由容器创建。注解可指定连接名等参数,具体参数以版本为准。

原理流程

  1. 方法标注 #[Transactional],扫描期纳入切面计划。
  2. 代理调用方法前开启事务。
  3. 方法正常返回提交,抛出异常回滚。
  4. 连接随事务结束归还。

代码或图示

use Hyperf\DbConnection\Annotation\Transactional;

class OrderService
{
    #[Transactional]
    public function create(array $payload): Order
    {
        $order = $this->repository->save($payload);
        $this->stock->deduct($payload['sku'], $payload['quantity']);
        return $order;
    }
}

常见误区

  • 类是 new 出来的:AOP 代理不生效,注解事务不会开启。
  • 方法内吞掉异常不抛出:切面感知不到失败,事务照常提交。

追问

  • 注解事务能指定连接吗?答:注解参数支持指定连接名的写法待确认,核对 Transactional 注解定义。
  • 注解事务与手动事务混用?答:同一业务路径避免重复开启;手动事务更适合复杂分支与多连接场景。

06.5.5.6-009 模型类如何定义?

一句话结论

模型继承 Hyperf ORM 模型基类,声明表名、连接名与可填充字段;模型封装表数据与常用查询方法,业务通过模型或查询构造器访问数据库。

概念解释

Hyperf ORM 与 Eloquent 风格相近(底层基于 illuminate/database 类组件,具体依赖待确认)。$fillable 控制批量赋值白名单,$connection 指定数据库连接。

原理流程

  1. 新建模型类继承模型基类。
  2. 声明 $table、$connection、$fillable 等属性。
  3. 控制器/服务通过模型静态方法或实例查询。
  4. 模型映射行数据为对象属性。

代码或图示

use Hyperf\DbConnection\Model\Model;

class Order extends Model
{
    protected ?string $table = 'orders';
    protected string $connection = 'default';
    protected array $fillable = ['user_id', 'amount', 'status'];
}

常见误区

  • 不设 $fillable 直接批量赋值:未白名单字段被过滤,数据写不进去。
  • 模型属性与表字段名不一致又不做映射:取值为 null。

追问

  • 主键与时间戳怎么配置?答:模型可声明主键字段;created_at/updated_at 自动时间戳行为按基类约定确认(待确认)。
  • 模型基类命名空间?答:Hyperf\DbConnection\Model\Model;版本间若有迁移需核对安装包。

06.5.5.6-010 查询构造器与模型查询怎么选择?

一句话结论

查询构造器适合灵活条件、聚合统计与原生 SQL 场景;模型查询适合单条记录、关联映射与实体操作;两者底层都走 DB 连接池,按可读性与性能选择。

概念解释

构造器返回数组/集合,模型返回实体对象。复杂报表、批量更新用构造器更直接;领域实体读写用模型保持封装。避免在热路径上滥用模型带来的实例化开销。

原理流程

  1. 按场景选择入口:Db::table() 构造器或 Model::query()。
  2. 链式拼接条件、排序、分页。
  3. 执行查询取得结果。
  4. 结果交业务层处理。

代码或图示

// 构造器:聚合统计
$total = Db::table('orders')
    ->where('status', 1)
    ->count();

// 模型:按主键取实体
$order = Order::where('user_id', $userId)->first();

常见误区

  • 大列表全量模型化:逐条实例化模型开销大,列表场景优先构造器或分批处理。
  • 构造器与模型混用同一查询条件不统一:条件分散容易遗漏。

追问

  • 原生 SQL 怎么写?答:Db::select($sql, $bindings) 类方法执行参数绑定 SQL;具体方法名以组件为准(待确认)。
  • 查询日志怎么开启?答:通过 DB 组件的 SQL 监听或日志配置;监听器注册方式对照文档(待确认)。

06.5.5.6-011 关联关系与预加载如何避免 N+1?

一句话结论

模型关联按需预加载(with)一次性取出关联数据,避免循环内逐条查询;N+1 表现为列表查出 N 条后每条再查一次关联,应在查询层合并为批量关联加载。

概念解释

Hyperf ORM 关联风格与 Eloquent 类似,关联定义在模型方法中;预加载通过 with 指定关联,框架生成批量查询填充到模型集合。具体关联方法名与参数以组件版本为准。

原理流程

  1. 先查主模型列表。
  2. with('关联名') 声明预加载关联。
  3. 框架按主表 ID 批量查询关联记录并回填。
  4. 遍历模型时不再触发单条关联查询。

代码或图示

// 预加载用户关联,避免循环内查用户
$orders = Order::with('user')->where('user_id', $userId)->get();

foreach ($orders as $order) {
    echo $order->user->name; // 命中预加载数据
}

常见误区

  • 循环内调用关联属性:触发懒加载,形成 N+1。
  • 预加载过多关联:单次查询变宽,内存与 SQL 复杂度上升,按页面需要选择。

追问

  • 如何定位 N+1?答:开启 SQL 日志观察同一列表请求出现大量同表单条查询;结合查询计数指标确认。
  • 关联条件能约束吗?答:预加载可带约束闭包;具体语法对照 ORM 文档(待确认)。

06.5.5.6-012 读写分离如何配置?

一句话结论

连接配置中区分 read 与 write 节点:写操作走主库,读操作走从库;框架按查询类型选择连接,事务内读写通常固定走主库保证一致性。

概念解释

读写分离配置在连接参数内分组定义读节点与写节点。只读查询分流到从库减轻主库压力;涉及主从延迟的场景(写完立即读)需强制走主库或容忍延迟。

原理流程

  1. 配置 read 节点列表与 write 节点。
  2. 组件按 SQL 类型选择对应节点连接。
  3. 事务与写语句绑定主库连接。
  4. 只读查询分配到读节点池。

代码或图示

'default' => [
    'read' => ['host' => env('DB_READ_HOST', '127.0.0.1')],
    'write' => ['host' => env('DB_WRITE_HOST', '127.0.0.1')],
    'pool' => ['min_connections' => 1, 'max_connections' => 10],
],

常见误区

  • 写完立刻读从库:主从延迟导致读到旧数据,关键一致性读应走主库。
  • 读节点多台不做负载策略:节点选择与均衡机制以组件实现为准(待确认)。

追问

  • 如何强制走主库?答:使用指定写连接或在事务内读取;具体强制主库 API 待确认。
  • 从库延迟怎么监控?答:结合复制延迟监控指标,对一致性敏感接口降级走主库。

06.5.5.6-013 连接池耗尽有什么现象,如何排查?

一句话结论

耗尽时新协程等待连接超过 wait_timeout 抛异常,表现为接口超时/报错;排查方向是连接占用未归还、长事务、慢 SQL、连接泄漏与池容量不足。

概念解释

池耗尽本质是占用速度超过归还速度。先看池空闲/占用指标与等待队列,再区分:事务未回滚、异常未归还、慢查询长占用、并发峰值超配置。

原理流程

  1. 报错信息确认是获取连接超时还是 SQL 执行超时。
  2. 查看池指标:空闲连接数、占用数、等待协程数。
  3. 审查长事务与慢 SQL 列表。
  4. 检查异常路径是否回滚/归还,必要时调大上限并对照数据库承载力。

代码或图示

// # 观察数据库当前连接与活跃会话(示例命令,按实际环境执行)
// # SHOW PROCESSLIST;
// # SHOW STATUS LIKE 'Threads_connected';

常见误区

  • 一耗尽就调大 max_connections:先找泄漏与慢查询,盲目扩容把压力转给数据库。
  • 忽略异常分支:事务在 catch 外回滚导致连接长期占用。

追问

  • 连接泄漏怎么复现定位?答:压测下观察占用连接只增不减;审查未关闭的手动连接持有与未回滚事务。
  • 池指标从哪里看?答:DB 连接池组件暴露的统计方法或可观测指标;具体 API 名待确认。

06.5.5.6-014 长空闲连接断线如何处理?

一句话结论

通过 max_idle_time 小于数据库 wait_timeout、心跳探测与失效连接重建避免借用死连接;连接被服务端关闭后池内检测到异常会丢弃并新建连接。

概念解释

数据库会主动关闭长时间空闲连接,应用池若不清理,下次借用拿到已关闭句柄报断连错误。心跳与空闲回收在借用前保证连接可用。

原理流程

  1. 查数据库 wait_timeout,应用 max_idle_time 设为更小值。
  2. 池后台按心跳检测连接活性。
  3. 空闲超期连接关闭回收,低于最小值补建。
  4. 借用时遇到失效连接,捕获后重建重试(重试策略以组件为准)。

代码或图示

'pool' => [
    'max_idle_time' => 60.0, // 小于数据库 wait_timeout
    'heartbeat' => 30,       // 心跳探测间隔(语义待确认)
],

常见误区

  • max_idle_time 大于服务端超时:死连接留在池内,借用才报错。
  • 心跳间隔过长:两次心跳之间连接可能已被关闭。

追问

  • 断线后组件自动重连吗?答:连接池会重建失效连接;自动重试次数与行为以组件实现为准(待确认)。
  • 服务端超时在哪里查?答:SHOW VARIABLES LIKE 'wait_timeout'; 按实例实际值配置应用回收参数。

06.5.5.6-015 慢查询如何定位与治理?

一句话结论

通过 SQL 日志、慢查询日志与执行计划定位耗时 SQL;治理手段包括补索引、改写条件、分页分批、避免全表扫描与大事务,先量化再优化。

概念解释

慢 SQL 长期占用连接,是池耗尽的常见诱因。定位链路:业务慢接口 → SQL 日志取语句 → EXPLAIN 看扫描行数与索引 → 优化索引或查询结构。

原理流程

  1. 开启 SQL 记录或收集数据库慢查询日志。
  2. 按耗时扫描 TOP 语句,提取 SQL 与绑定参数。
  3. EXPLAIN 检查访问类型、索引命中与扫描行数。
  4. 补充索引或改写查询,分批处理大结果集。

代码或图示

// -- 查看执行计划(示例)
// EXPLAIN SELECT id, user_id FROM orders WHERE status = 1 ORDER BY created_at DESC LIMIT 20;

常见误区

  • 只加索引不看回表成本:宽表索引覆盖不足时仍大量回表。
  • 大表 SELECT *:取字段过多,网络与内存开销上升。

追问

  • 慢查询日志在哪里配置?答:数据库服务端慢查询参数;应用侧 SQL 监听记录语句与耗时。
  • 批量更新怎么控制影响?答:按主键分批更新,每批小事务,避免长事务锁表。

06.5.5.6-016 分页与批量处理怎么避免内存爆掉?

一句话结论

大数据量使用分页或游标分批读取,逐批处理后释放;避免一次性 get() 全量结果集,常驻进程内存被大结果集长期占用。

概念解释

常驻模型下一次性加载大列表会把全部行驻留内存。分批方式包括分页 forPage、游标 chunk/cursor 类方法(具体 API 待确认),每批处理完释放当前结果。

原理流程

  1. 按主键或排序键确定分批边界。
  2. 每批取固定条数,执行业务后释放。
  3. 推进游标/页码处理下一批。
  4. 全程内存占用稳定在单批规模。

代码或图示

// 分批处理概念示例;具体分批方法名以 ORM 版本为准(待确认)
Order::query()->chunk(200, function (array $orders) {
    foreach ($orders as $order) {
        // 逐条处理
    }
});

常见误区

  • 分页越翻越深(大 offset):扫描成本高,深分页改用游标/主键范围。
  • 批内再查关联:分批场景也要预加载,避免 N+1 放大。

追问

  • 分批处理中途失败怎么办?答:记录批次进度与幂等标识,支持断点续跑;业务操作保证可重试。
  • 内存占用怎么观测?答:对比处理前后进程内存,确认每批结果及时释放。

06.5.5.6-017 原生 SQL 与参数绑定如何写才安全?

一句话结论

执行原生 SQL 使用占位符与绑定参数,不拼接用户输入进 SQL 字符串;参数绑定由组件处理转义,避免 SQL 注入并提升预处理复用。

概念解释

白名单字段/排序名不能用参数绑定,需在代码内校验后拼接;值参数一律走绑定。复杂 SQL 可结合查询构造器条件,减少手写字符串。

原理流程

  1. 编写带 ? 或命名占位符的 SQL。
  2. 绑定参数按顺序/名称传入。
  3. 组件预处理后绑定执行。
  4. 结果以数组返回。

代码或图示

$orders = Db::select(
    'SELECT id, amount FROM orders WHERE user_id = ? AND status = ?',
    [$userId, $status]
);

常见误区

  • 把 $_GET 直接拼进 SQL 字符串:注入风险。
  • 表名/列名用绑定参数:标识符不能参数化,需白名单校验。

追问

  • 写操作原生 SQL 怎么执行?答:Db::update/Db::delete 类方法或执行语句接口;方法名以组件为准(待确认)。
  • 预处理缓存受什么影响?答:占位符一致可复用预处理;拼接动态条件会降低复用率。

06.5.5.6-018 模型事件与观察器有哪些使用方式?

一句话结论

模型在保存、更新、删除等节点提供事件钩子,可挂观察器做日志、派生数据或校验;事件在模型生命周期内触发,使用时注意常驻单例与协程隔离。

概念解释

具体事件方法名与注册方式以 ORM 基类版本为准(待确认)。模型事件适合跨模型的通用副作用;业务规则仍应在服务层显式处理,避免副作用隐藏在模型钩子中。

原理流程

  1. 在模型定义事件钩子方法或注册观察器。
  2. 模型执行对应生命周期动作时触发事件。
  3. 钩子内执行日志、派生字段、校验等逻辑。
  4. 事件异常按模型事务语义传播。

代码或图示

class Order extends Model
{
    // 钩子方法名以基类约定为准(待确认)
    protected function onSaved(): void
    {
        // 保存后的派生逻辑
    }
}

常见误区

  • 在模型钩子里发 RPC/消息:模型层变重,且事务提交边界不易控制。
  • 钩子内保存请求态上下文:模型被多协程复用,不能写成员可变状态。

追问

  • 观察器如何注册?答:按组件配置或模型属性登记;注册位置待确认,对照 ORM 文档。
  • 模型事件影响性能吗?答:每个模型动作触发钩子,热路径需评估钩子内逻辑成本。

06.5.5.6-019 多数据库与连接命名如何组织?

一句话结论

按业务域或环境划分连接名,模型与代码按名获取;连接命名统一规范,避免散落硬编码主机,新库通过新增连接配置接入而不改业务代码结构。

概念解释

常见划分:主业务库、只读库、报表库、外部对接库。模型声明默认连接,跨库查询显式指定连接;连接名作为配置标识与代码解耦。

原理流程

  1. 在 databases.php 按连接名定义各组配置。
  2. 模型 $connection 指定默认连接。
  3. 服务层用 Db::connection('name') 访问指定库。
  4. 环境差异通过环境变量切换节点。

代码或图示

// 模型绑定指定连接
class Report extends Model
{
    protected string $connection = 'report';
}

// 代码层显式取连接
$summary = Db::connection('report')->table('daily_stats')->get();

常见误区

  • 跨库 JOIN 依赖同实例:实例拆分后跨库 JOIN 失效,需在应用层组装。
  • 连接名拼写不一致导致落到默认库:统一常量或枚举管理连接名。

追问

  • 连接可以运行时动态切换吗?答:按连接名获取对应池;不建议在单例服务内持有可变当前连接。
  • 多库事务怎么处理?答:跨库无法使用本地单事务,需 Saga/本地消息表等最终一致方案。

06.5.5.6-020 数据库连接数规划如何对照数据库承载力?

一句话结论

应用侧总连接上限按实例 max_connections 的安全比例分配,结合 Worker 数与单 Worker 并发借用峰值估算;预留管理连接余量,避免应用池把数据库打满。

概念解释

每个应用实例的 max_connections 乘以实例数,不能超过数据库允许连接总数。连接数规划要考虑部署副本数、队列消费者、定时任务等所有连库进程,不只算 Web Worker。

原理流程

  1. 查数据库 max_connections 与当前常态连接。
  2. 统计所有应用副本、消费者、任务进程的连接池上限。
  3. 按安全比例(如 60%–70%)分配应用总连接,预留管理与突发余量。
  4. 压测验证峰值借用,调整池参数。

代码或图示

// 数据库 max_connections = 500
// → 应用总连接建议 300–350
// → 单实例 max_connections × 实例数 + 消费者/任务连接 ≤ 应用总连接

常见误区

  • 只按单机并发算连接数:遗漏多副本与异步进程,上线后连接超限。
  • 池上限等于数据库上限:没有预留管理连接与突发空间。

追问

  • 连接数过高数据库有什么表现?答:连接拒绝、排队、内存上涨;监控连接数与等待线程指标。
  • 连接数过低呢?答:池频繁排队等待,接口超时;结合慢查询与并发峰值调整。