[13.x] Exception is thrown when model is created using factory

[gabrielrbarbosa]

Laravel Version

13.0.0

PHP Version

8.5.0

Database Driver & Version

MariaDB 11.4

Description

Related to https://github.com/laravel/framework/pull/55685/changes

Database\Seeders\ProdutoTableSeeder ...................................................................................................... RUNNING  

   LogicException 

  The [Illuminate\Database\Eloquent\Model::bootIfNotBooted] method may not be called on model [App\Models\Produto\Categoria\SubcategoriaProduto] while it is being booted.

  at vendor/laravel/framework/src/Illuminate/Database/Eloquent/Model.php:334
    330▕     protected function bootIfNotBooted()
    331▕     {
    332▕         if (! isset(static::$booted[static::class])) {
    333▕             if (isset(static::$booting[static::class])) {
  ➜ 334▕                 throw new LogicException('The ['.__METHOD__.'] method may not be called on model ['.static::class.'] while it is being booted.');
    335▕             }
    336▕ 
    337▕             static::$booting[static::class] = true;
    338▕ 

      +2 vendor frames 

  3   app/Models/Produto/Categoria/SubcategoriaProduto.php:52
      Illuminate\Database\Eloquent\Model::observe()
      +9 vendor frames 

  13  database/factories/Produto/ProdutoFactory.php:51
      Illuminate\Database\Eloquent\Factories\Factory::create([])

Seeder is basically this: $produtoFactory = Produto::factory()->create(); and product factory calls SubcategoriaProduto::factoy();

Steps To Reproduce

php artisan migrate:fresh --seed

[alaminfirdows]

This happens because observe() is being called inside boot() while the model is still booting, causing a circular re-entry.

It might be fixed by replacing boot() with booted() in SubcategoriaProduto.php:

// ❌ boot()
protected static function boot()
{
    parent::boot();
    static::observe(SubcategoriaProdutoObserver::class);
}

// ✅ booted()
protected static function booted()
{
    static::observe(SubcategoriaProdutoObserver::class);
}

booted() runs after the model finishes booting, avoiding the conflict.

[gabrielrbarbosa]

@alaminfirdows this does work but is this a new expected breaking change or maybe should not throw this for all model that uses observers?

[gabrielrbarbosa]

found it here

[alaminfirdows]

found it here

Great! I also came across the same reference.

[yajra]

When working with traits, it seems like we need to use whenBooted

trait AuditableTrait
{
    public static function bootAuditableTrait(): void
    {
        static::whenBooted(function () {
            static::observe(new AuditableTraitObserver);
        });
    }

[martinbean]

When working with traits, it seems like we need to use whenBooted

@yajra Or you can do it in an initialize[TraitName] method instead:

trait AuditableTrait
{
    public function initializeAuditableTrait(): void
    {
        static::observe(new AuditableTraitObserver);
    }
}