Error al ejecutar migraciones
Qué hacer cuando php artisan migrate o php artisan tenancy:migrate se detiene porque una tabla ya existe.
Cuándo usarla
Al actualizar el facturador, la migración falla con un mensaje como este:
SQLSTATE[42S01]: Base table or view already exists: 1050 Table 'dispatch_sale_notes' already exists

Pasa cuando la tabla ya se creó (por una migración que se cortó a la mitad o por un cambio manual), pero Laravel no la tiene registrada como ejecutada. Mientras no se resuelva, las migraciones siguientes tampoco se aplican.
Antes de empezar
- Genere un respaldo de la base de datos (Generar copias de seguridad).
- Anote el nombre de la tabla y el de la migración que aparecen en el error.
Pasos
-
Abra el archivo de la migración que falló. Está en
database/migrations/tenant/si el error salió entenancy:migrate, o endatabase/migrations/si salió enmigrate. -
Envuelva la creación de la tabla en una condición, para que la migración no haga nada si la tabla ya existe:
public function up() { if (!Schema::hasTable('dispatch_sale_notes')) { Schema::create('dispatch_sale_notes', function (Blueprint $table) { // ... el contenido original, sin cambios }); } } -
Dentro del contenedor
fpm, vuelva a ejecutar las migraciones:php artisan migrate php artisan tenancy:migrate -
Cuando terminen sin errores, descarte el cambio en el archivo para que la próxima actualización no tenga conflictos con git:
git checkout -- database/migrations
Cómo verificar
Las migraciones terminan sin errores. Para confirmar que no queda ninguna pendiente:
php artisan migrate:status | grep -i pending
Si el comando no muestra nada, no hay migraciones pendientes.
Si algo sale mal
| Síntoma | Qué hacer |
|---|---|
| Falla otra migración con el mismo error | Repita los pasos con esa migración. |
| Column already exists o Duplicate column name | Mismo caso, pero con una columna: envuelva el $table->... de esa columna en if (!Schema::hasColumn('tabla', 'columna')). |
| La tabla existe pero le faltan columnas | No use la condición: la tabla quedó a medias. Restaure el respaldo o escriba a soporte con el error completo. |