No Laravel 12, $this->middleware() no construtor do controller não existe mais

[!NOTE] Resumo Executivo (DEV-2026-122): Oito controllers de API chamavam $this->middleware() no construtor. O controller base mais novo não tem esse método, então essas rotas respondem 500 com Call to undefined method.


🚨 O Desafio Técnico / Contexto

Desde o Laravel 11, a classe Controller do esqueleto é vazia e não herda o método middleware(). Os controllers antigos foram mantidos, e o erro só aparecia ao chamar a rota. Parte dos testes dessas APIs falhava por isso.


💡 Principais Lições Aprendidas & Descobertas

  • 💡 O erro só aparece em tempo de execução. O php -l passa, e só um teste que chama a rota mostra.
  • 💡 Antes de remover a linha, confira se a rota já exige login pelo grupo: php artisan route:list –path=api/x –json mostra o middleware aplicado.
  • 💡 A linha pedia auth:sanctum, e o grupo usa auth. Remover mantém o login, mas não necessariamente o mesmo mecanismo pensado na época.
  • 💡 Remover pode ligar uma rota que estava morta. Leia o que ela faz antes, porque ela pode nunca ter sido exercitada com essa versão.
  • 💡 A alternativa para middleware por controller é declarar no grupo de rotas ou implementar a interface HasMiddleware.

🛠️ Especificação Técnica & Código-Chave

# Quantos ainda têm o problema?
grep -rln '$this->middleware(' app/Http/Controllers

📈 Impacto no Ecossistema & Valor Prático

Os controllers com o erro ficaram listados, e os que tratam de dado sensível só voltam depois de revisados.

  • Projetos Relacionados: sistema-de-atendimento
  • Registro de Origem: _data/daily.dev-19.yml

Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.