Migração de SQLite para MySQL 9.1 com InnoDB Forçado e Isolamento de Testes no Laravel 11
[!NOTE] Resumo Executivo (DEV-2026-138): A migração do ERP de SQLite para MySQL 9.1 exigiu parametrização de engine InnoDB estrita e revisão do ciclo de testes. Desativamos rotinas destrutivas de bootstrap preservando simulações no banco corporativo.
🚨 O Desafio Técnico / Contexto
O driver padrão do MySQL criava tabelas sob collation e engines legadas quando omitidas, gerando falhas em chaves estrangeiras com cascades e deadlocks durante a instalação modular de 11 plugins. Simultaneamente, o helper de testes executava migrate:fresh a cada execução do Pest, apagando a base MySQL de desenvolvimento.
💡 Principais Lições Aprendidas & Descobertas
- 💡 Forçar ‘engine’ => ‘InnoDB’ na conexão mysql do config/database.php garante integridade relacional entre plugins.
- 💡 TestBootstrapHelper não pode invocar migrate:fresh em ambientes locais com dados persistidos de simulação.
- 💡 O uso da trait DatabaseTransactions no Pest isola cada teste revertendo commits sem truncar tabelas.
- 💡 Comandos que acessam soquetes de rede locais no Windows exigem desvio de isolamento quando executados fora do servidor.
🛠️ Especificação Técnica & Código-Chave
'mysql' => [
'driver' => 'mysql',
'engine' => 'InnoDB',
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'prefix' => '',
'strict' => true,
],
📈 Impacto no Ecossistema & Valor Prático
Ambiente de desenvolvimento e testes rodando sobre MySQL real com isolamento de transações em 16 segundos.
- Projetos Relacionados:
laravel-ERP - Registro de Origem:
_data/daily.dev-23.yml
Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.