Saltar al contenido
Facturador

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

Error de migración

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

  1. Abra el archivo de la migración que falló. Está en database/migrations/tenant/ si el error salió en tenancy:migrate, o en database/migrations/ si salió en migrate.

  2. 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
            });
        }
    }
    
  3. Dentro del contenedor fpm, vuelva a ejecutar las migraciones:

    php artisan migrate
    php artisan tenancy:migrate
    
  4. 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.