Приложение Laravel с поддержкой чтения и записи в базу данных выполняет запись на основной сервер (primary), а чтение — с одного или нескольких реплик. Каждая реплика копирует изменения с основного сервера, но может отставать. Пользователь, который сохраняет форму и переходит на следующую страницу, может увидеть устаревшие данные, так как эта страница выполняла чтение с реплики, которая еще не получила данные записи.
Обычно эту проблему решают с помощью временного окна. В течение нескольких секунд после операции записи запросы на чтение этого пользователя направляются на основной сервер. В Laravel 13.38 появился middleware PreventStaleDatabaseReads , который реализует такой подход со значением по умолчанию в две секунды. Две секунды — это фиксированная оценка задержки репликации. Если это окно короче задержки репликации, пользователь все равно увидит старые данные. Если оно длиннее, чтение пойдет на основной сервер даже в том случае, если реплика уже получила данные.
В Laravel 13.40 добавлены три метода для работы с соединениями, автором которых является Тобиас Петри (Tobias Petry). Они позволяют напрямую опрашивать реплику. Вы фиксируете позицию основного сервера после записи, а затем запрашиваете реплику, достигла ли она этой позиции.
#Запись и проверка идентификатора коммита (Commit ID)
use Illuminate\Support\Facades\DB; // After a write, on the primary $order = Order::create([...]); $commitId = DB::getLastCommitId(); // Later, on the read connection DB::hasCommitId($commitId); // checks once and returns at once DB::hasCommitId($commitId, wait: 2); // waits up to 2 seconds for the replica // Combine IDs from several writes into one $combined = DB::mergeCommitIds([$firstId, $secondId]);
Метод getLastCommitId() всегда выполняет запрос к соединению записи. Он возвращает текущую позицию репликации основного сервера в виде строки. Формат зависит от используемой базы данных:
| База данных | Commit ID | Пример |
|---|---|---|
| MySQL | Набор GTID из @@global.gtid_executed |
3e11fa47-71ca-11e1-9e33-c80aa9429562:1-77 |
| MariaDB | Позиция GTID из @@gtid_binlog_pos |
0-1-1052 |
| PostgreSQL | Позиция WAL из pg_current_wal_lsn() |
0/16B3748 |
Метод hasCommitId() возвращает true , когда сервер применил все изменения вплоть до указанного идентификатора коммита. Аргумент wait задает таймаут в целых секундах. При значении wait: 0 , используемом по умолчанию, метод выполняет проверку один раз. Если указать большее значение, база данных будет заблокирована до тех пор, пока реплика не догонит основной сервер или не истечет таймаут (в этом случае будет возвращено значение false ).
Метод mergeCommitIds() принимает массив идентификаторов коммитов и возвращает один идентификатор, объединяющий их все. В PostgreSQL он возвращает наибольшую позицию WAL. В MySQL и MariaDB он объединяет наборы GTID, поэтому результат охватывает записи с нескольких основных серверов. Если передан пустой массив, выбрасывается исключение RuntimeException .
#Требования к базе данных
| База данных | Настройки сервера | Аргумент wait |
|---|---|---|
| MySQL | log_bin , gtid_mode = ON и enforce_gtid_consistency = ON |
Поддерживается |
| MariaDB | log_bin |
Поддерживается |
| PostgreSQL | Нет | PostgreSQL 19 и новее |
| SQLite, SQL Server | Не поддерживается | Не поддерживается |
В MySQL 8 бинарное логирование включено по умолчанию, но GTID — нет. В MariaDB бинарное логирование по умолчанию отключено. Если какая-то настройка отсутствует, метод getLastCommitId() выбросит исключение RuntimeException с перечислением недостающих параметров. Соединения с SQLite и SQL Server будут выбрасывать ошибку при каждом вызове. В PostgreSQL 18 и более ранних версиях вызов hasCommitId() с аргументом wait приведет к ошибке даже на основном сервере. Облачные базы данных могут не разрешать изменять эти настройки.
#На каком сервере выполняется проверка hasCommitId()
Метод hasCommitId() выполняет запрос select , поэтому он направляется на тот же сервер, что и остальные операции чтения в рамках текущего запроса. В следующих случаях это будет основной сервер:
- Вызов происходит внутри транзакции базы данных
- Для соединения включена опция
sticky, и в рамках текущего запроса уже выполнялась запись - Чтение принудительно направляется на сервер записи с помощью
useWriteConnectionWhenReading()илиusingWritePdo()
Основной сервер всегда содержит собственные коммиты, поэтому в таких случаях метод возвращает true . Результат остается корректным и для последующих запросов на чтение, поскольку они также направляются на основной сервер.
Соединение сохраняет один экземпляр PDO для чтения на время обработки HTTP-запроса. Если в секции read указано несколько хостов, Laravel выбирает хост при открытии соединения, и как сама проверка, так и последующие запросы выполняются на нем. Следующий запрос может выбрать другую реплику, поэтому проверяйте состояние на каждом запросе, а не сохраняйте результат.
#Чтение собственных записей с помощью middleware сессии
Этот middleware работает по тому же принципу, что и PreventStaleDatabaseReads , но вместо временной метки сохраняет идентификатор коммита. При каждом запросе он спрашивает реплику, догнала ли она основной сервер. Если реплика содержит нужную запись, чтение выполняется с нее, а ключ сессии удаляется. Если нет — чтение направляется на основной сервер:
namespace App\Http\Middleware; use Closure; use Illuminate\Http\Request; use Illuminate\Support\Facades\DB; use Symfony\Component\HttpFoundation\Response; class ReadYourOwnWrites { public function handle(Request $request, Closure $next): Response { $pending = $request->session()->get('db_commit_id'); if ($pending !== null) { if (DB::hasCommitId($pending)) { $request->session()->forget('db_commit_id'); $pending = null; } else { DB::useWriteConnectionWhenReading(); } } $response = $next($request); if (DB::hasModifiedRecords()) { $commitId = DB::getLastCommitId(); $request->session()->put('db_commit_id', $pending === null ? $commitId : DB::mergeCommitIds([$pending, $commitId])); } return $response; } }
Добавьте его в группу web в файле bootstrap/app.php , чтобы он выполнялся внутри middleware сессии:
use App\Http\Middleware\ReadYourOwnWrites; ->withMiddleware(function (Middleware $middleware) { $middleware->web(append: [ ReadYourOwnWrites::class, ]); })
При редактировании записи запрос PUT обновляет данные, а middleware сохраняет ID коммита основного сервера в сессии. Перенаправленный запрос GET запрашивает у реплики этот ID. При задержке в 50 миллисекунд реплика обычно уже успевает получить обновление, поэтому страница загружается с реплики. Если же задержка составляет 10 секунд, то запрос GET и все последующие будут обращаться к основному серверу, пока реплика не догонит его.
Если пользователь выполнит еще одну запись до того, как очистится предыдущий ID, метод mergeCommitIds() объединит их, так что в сессии будет храниться один идентификатор, охватывающий обе операции.
Этот middleware использует немедленную проверку. Использование таймаута wait в веб-запросе заблокировало бы отправку ответа до тех пор, пока реплика не догонит изменения, в то время как основной сервер мог бы обслужить эти запросы гораздо быстрее.
#Ожидание реплики в фоновой задаче (queued job)
Задача, отправленная в очередь сразу после записи, может начать выполняться раньше, чем строка появится на реплике. У воркера очереди нет сессии, поэтому передайте ID коммита в задачу и выполните ожидание с помощью метода handle() :
use App\Jobs\SendOrderConfirmation; use Illuminate\Support\Facades\DB; $order = DB::transaction(function () use ($request) { $order = Order::create([...]); $order->lines()->createMany([...]); return $order; }); SendOrderConfirmation::dispatch($order->id, DB::getLastCommitId());
Вызывайте getLastCommitId() после фиксации транзакции (commit). Внутри транзакции изменения еще не зафиксированы на основном сервере, поэтому ID не будет их содержать.
namespace App\Jobs; use App\Mail\OrderConfirmation; use App\Models\Order; use Illuminate\Contracts\Queue\ShouldQueue; use Illuminate\Foundation\Queue\Queueable; use Illuminate\Support\Facades\DB; use Illuminate\Support\Facades\Mail; class SendOrderConfirmation implements ShouldQueue { use Queueable; public function __construct( public int $orderId, public string $commitId, ) {} public function handle(): void { if (DB::hasCommitId($this->commitId, wait: 2)) { $this->send(); return; } DB::usingWritePdo(fn () => $this->send()); } protected function send(): void { $order = Order::with('lines', 'customer')->findOrFail($this->orderId); Mail::to($order->customer)->send(new OrderConfirmation($order)); } }
Задача должна принимать ID заказа, а не модель Order . При использовании трейта SerializesModels Laravel загружает свойства модели из базы данных до запуска метода handle() . Этот запрос уйдет на реплику до проверки ID коммита, и на отстающей реплике это приведет к ошибке ModelNotFoundException .
В качестве запасного варианта используется usingWritePdo() вместо useWriteConnectionWhenReading() . Воркер очереди переиспользует соединение с базой данных между задачами, а usingWritePdo() восстанавливает предыдущие настройки после завершения callback-функции, чтобы последующие задачи могли продолжать чтение с реплик.
#Дополнительные материалы
- Slow Job Alerts and Replica Commit IDs in Laravel 13.40
- Laravel Read Replicas: Prevent Stale Reads After a Write
- Reset Sticky Database Connections Between Laravel Queue Jobs
Тобиас Петри добавил поддержку идентификаторов коммитов в пул-реквесте #62198.
Комментарии (0)
Пока нет комментариев — будьте первым.