Posted on: January 08, 2026 06:34 PM
Posted by: Renato
Categories: Laravel
Views: 182
To lock or not to lock? 🔒 Bloquear ou não bloquear?
🔒 Bloquear ou não bloquear?
Por quê?
Antes de tudo, precisamos entender por que precisamos de locking (bloqueio) no banco de dados, e nada melhor do que um cenário da vida real para isso.
Suponha que você seja assinante do meu conteúdo premium no Medium (não se preocupe, meu conteúdo é gratuito 😊) por US$ 5 por mês.
Vamos assumir que o Medium tenha um cronjob que cobra seu cartão por volta da meia-noite e, para efeito deste artigo, vamos supor que você tenha apenas US$ 5 no cartão (Deus me livre 😱).
Agora, como a boa coruja noturna 🦉 que você é, você está navegando pelo universo do Medium e encontra outra pessoa que escreve conteúdos legais sobre Angular —
Enea Jahollari (não se preocupe, o conteúdo dele também é gratuito).
Você então decide se inscrever também, por US$ 5.
E acontece que o exato momento em que você clica em “subscribe” é o mesmo momento em que o cronjob está processando a cobrança.
Quando dois ou mais clientes tentam atualizar o mesmo registro ao mesmo tempo, pode ocorrer um conflito conhecido como race condition (condição de corrida).
O cronjob lê o registro e vê que você tem US$ 5.
Ao mesmo tempo, quando você clica em “subscribe”, o sistema também lê o registro e vê que você tem US$ 5.
Ambos seguem adiante e atualizam a coluna amount (claro, o Medium é muito mais sofisticado do que isso), e dessa forma acabamos com um valor inconsistente no banco.
🧠 Duas abordagens para concorrência em banco de dados
Existem duas abordagens principais para lidar com acesso e modificação concorrente de dados em um banco de dados.
🔐 Pessimistic Locking (Bloqueio Pessimista)
O pessimistic locking, também conhecido como pessimistic concurrency control, é um mecanismo que assume que conflitos vão acontecer e, por isso, adota uma abordagem cautelosa.
Ao usar esse tipo de bloqueio, você bloqueia explicitamente um registro (ou conjunto de registros) ao acessá-lo, impedindo que outros processos ou threads o modifiquem até que o lock seja liberado.
Essa abordagem é útil quando:
-
Conflitos são prováveis
-
Você precisa garantir acesso exclusivo aos dados
🔓 Optimistic Locking (Bloqueio Otimista)
O optimistic locking, também conhecido como optimistic concurrency control, adota uma abordagem mais confiante e assume que conflitos são raros.
Nesse modelo:
-
Os registros não são bloqueados durante a leitura
-
Usa-se um campo de versão ou timestamp para detectar conflitos no momento da escrita
Ao atualizar um registro, você compara a versão (ou timestamp) atual com a que foi lida inicialmente.
Se forem diferentes, significa que alguém alterou o registro nesse meio tempo, e o conflito pode ser tratado adequadamente.
⚙️ Como usar isso no Laravel?
🔒 Pessimistic Locking no Laravel
No Laravel, você pode usar bloqueio pessimista chamando o método lockForUpdate() no Query Builder antes de buscar ou modificar os registros.
Exemplo:
$user = User::where('id', $userId)
->lockForUpdate()
->first();
O método lockForUpdate() adiciona a cláusula FOR UPDATE à query SQL, bloqueando as linhas selecionadas até que:
-
A transação seja finalizada, ou
-
O lock seja liberado
🔓 Optimistic Locking no Laravel
O Laravel suporta optimistic locking através do uso de timestamps.
Por padrão, o Laravel adiciona as colunas:
-
created_at
-
updated_at
Essas colunas podem ser usadas para detectar concorrência.
Quando você atualiza um registro, o Laravel verifica automaticamente se o valor de updated_at mudou desde que o registro foi carregado.
Se tiver mudado, uma exceção Illuminate\Database\Eloquent\ModelNotFoundException será lançada, indicando um conflito.
🖼️ Transcrição da imagem anexada
<?php
DB::transaction(function () use ($id, $charge) {
$currentAmount = DB::table('users')
->where('id', $id)
->lockForUpdate()
->first('amount');
DB::table('users')
->where('id', $id)
->update(['amount' => ($currentAmount - $charge)]);
return true;
}, 3);
📌 Explicação do código
-
Linha 4: Primeiro, lemos o saldo atual do usuário que será debitado.
-
Linha 6: Aplicamos o lockForUpdate(), garantindo que nenhum outro processo consiga modificar esse registro até que o lock seja liberado.
-
Linha 9: Atualizamos o saldo do usuário subtraindo o valor cobrado.
-
Linha 15: Utilizamos DB::transaction() com 3 tentativas, uma boa prática para evitar deadlocks.
⚠️ Nota importante
Para usar transactions no MySQL, é necessário que o banco esteja usando o engine InnoDB.
📣 Fique à vontade para se inscrever, bater palmas 👏🏻, comentar 💬 e compartilhar este artigo com quem quiser.
Como sempre, agradeço muito o seu apoio.
Obrigado pela leitura! 🙌
Exemplo:
// The Laravel query builder includes a `lockForUpdate()` function.
// This stops any updates or another shared lock on selected record
// until the transaction is finalized.
DB::transaction(function() {
$user = User::lockForUpdate()->find(1);
});
// There is also sharedLock() function that only prevents updates on
// the selected record but permits selecting the record with another lock.
DB::transaction(function() {
$user = User::sharedLock()->find(1);
});
// For more tips 👉 @justsanjit 👈
💡 Analogia rápida para fixar:
Pense no banco de dados como um arquivo físico em um escritório:
-
lockForUpdate() é como trancar o arquivo na sua mesa: ninguém mais pode mexer até você terminar.
-
sharedLock() é como deixar o arquivo em uma mesa de leitura: várias pessoas podem ler, mas ninguém pode alterar enquanto ele está ali.
Fonte: https://medium.com/@erlandmuchasaj/to-lock-or-not-to-lock-974afdfe0b02
O método lockForUpdate() é uma funcionalidade clássica do Laravel para lidar com concorrência no banco de dados (Pessimistic Locking).
Ele foi implementado originalmente no Laravel 4.0, lançado em maio de 2013.
Desde então, ele permanece como uma ferramenta essencial para garantir que uma linha do banco de dados não seja alterada por outro processo enquanto a sua transação atual a estiver processando.
Dica importante: O suporte para esses locks depende do seu motor de banco de dados. No MySQL, por exemplo, você precisa estar usando o motor InnoDB, pois o MyISAM não suporta locks de linha, apenas de tabela inteira.
Donate to Site
Renato
Developer
-
Rlucena - há 4 meses
O método lockForUpdate() é uma funcionalidade clássica do Laravel para lidar com concorrência no banco de dados (Pessimistic Locking). Ele foi implementado originalmente no Laravel 4.0, lançado em maio de 2013. Desde então, ele permanece como uma ferramenta essencial para garantir que uma linha do banco de dados não seja alterada por outro processo enquanto a sua transação atual a estiver processando. Dica importante: O suporte para esses locks depende do seu motor de banco de dados. No MySQL, por exemplo, você precisa estar usando o motor InnoDB, pois o MyISAM não suporta locks de linha, apenas de tabela inteira.
