MissingRulesException when validating Form objects with boolean properties in Volt components

[amoktar]

Livewire version

4.1.0

Laravel version

12.48.1

Which PHP version are you using?

PHP 8.2

What is the problem?

When using a Livewire Form object within a Volt component, calling $this->form->validate() throws a MissingRulesException if the form contains a boolean property that has been updated via wire:model. The error message states: "Missing [$rules/rules()] property/method on: [component-name]."

The issue occurs because Livewire incorrectly tries to find validation rules on the parent Volt component instead of the Form object during the hydration/validation cycle.

Code snippets

Steps to Reproduce

1. Create a Livewire Form with validation rules including a boolean property

<?php
// app/Livewire/Forms/LoginForm.php

namespace App\Livewire\Forms;

use Livewire\Attributes\Validate;
use Livewire\Form;

class LoginForm extends Form
{
    #[Validate('required|string|email')]
    public string $email = '';

    #[Validate('required|string')]
    public string $password = '';

    #[Validate('boolean')]
    public bool $remember = false;  // ← The boolean property that triggers the bug

    public function authenticate(): void
    {
        $this->validate(); // ← This is where the exception is thrown
        
        // Authentication logic...
    }
}

2. Create a Volt component that uses the Form object

<?php
// resources/views/livewire/pages/auth/login.blade.php

use App\Livewire\Forms\LoginForm;
use Livewire\Attributes\Layout;
use Livewire\Volt\Component;

new #[Layout('layouts.guest')] class extends Component
{
    public LoginForm $form;

    public function login(): void
    {
        $this->form->validate(); // ← MissingRulesException thrown here
        
        $this->form->authenticate();
    }
}; ?>

<div>
    <form wire:submit="login">
        <input wire:model="form.email" type="email" />
        <input wire:model="form.password" type="password" />
        
        <!-- This checkbox causes the issue when checked -->
        <input wire:model="form.remember" type="checkbox" />
        
        <button type="submit">Log in</button>
    </form>
</div>

3. Reproduce the error

1. Visit the login page in a browser
2. Fill in the email and password fields
3. Check the "remember" checkbox (set form.remember to true)
4. Submit the form
5. Error: Livewire\Exceptions\MissingRulesException: Missing [$rules/rules()] property/method on: [pages.auth.login].

Expected Behavior

The $this->form->validate() call should validate the LoginForm object using its #[Validate] attributes, regardless of the values of the form properties. The validation should succeed (or fail with field-specific errors if data is invalid), but should not throw a MissingRulesException.

Actual Behavior

When form.remember is set to true and the form is submitted, Livewire throws:

Livewire\Exceptions\MissingRulesException: Missing [$rules/rules()] property/method on: [pages.auth.login].

This occurs at line 18 of the compiled Volt component when calling $this->form->validate().

Important:

• If form.remember is false or not included in the wire:model binding, everything works correctly
• The issue only occurs when the boolean property is true and sent via HTTP request
• Unit tests using Livewire\Volt\Volt::test() do NOT reproduce the error (tests pass)
• The error ONLY occurs in actual browser requests

Why Tests Don't Reproduce the Error

The bug does not manifest in Livewire's test helpers (Volt::test() or Livewire::test()). Tests pass even with remember=true:

// This test PASSES but the same scenario FAILS in browser
Volt::test('pages.auth.login')
    ->set('form.email', 'user@example.com')
    ->set('form.password', 'password')
    ->set('form.remember', true)  // ← Works in tests, fails in browser
    ->call('login')
    ->assertHasNoErrors(); // ✅ Test passes

his indicates the bug is specifically in Livewire's JavaScript→PHP hydration layer when handling serialized component state from actual HTTP requests, not in the core validation logic itself.

Environment

• Livewire Version: 4.x (latest)
• Livewire Volt Version: 1.x (latest)
• Laravel Version: 12.48.1
• PHP Version: 8.2.12
• Browser: Chrome 144.0.0.0 (also tested in other browsers with same result)

Additional Context

Why This Matters

This is a critical bug for authentication flows using Volt components, as "remember me" functionality is a common requirement. Users cannot log in with "remember me" enabled.

Potential Root Cause

Based on the error message and behavior, it appears that when Livewire deserializes the component state from the JavaScript HTTP POST request, it incorrectly attempts to resolve validation rules on the parent Volt component instance instead of the nested LoginForm object when certain boolean properties are present in the updates.

The validation rule resolution seems to be looking at $this (the Volt component) instead of $this->form (the Form object) during the hydration process when remember=true is in the payload.

Workaround

Until this is fixed, the temporary workarounds are:

1. Don't use boolean properties in Form objects (use string 'yes'/'no' or integer 0/1 instead)
2. Add a dummy rules() method to the Volt component (hacky but works):

new #[Layout('layouts.guest')] class extends Component
{
    public LoginForm $form;

    // Workaround: Add dummy rules method
    protected function rules(): array
    {
        return [];
    }

    public function login(): void
    {
        $this->form->validate();
        $this->form->authenticate();
    }
}

3. Use standard Livewire components instead of Volt (issue doesn't occur with regular Livewire classes)

Related Information

• The Form object has proper validation rules defined using #[Validate] attributes
• The issue is specifically triggered when a boolean property transitions from false to true
• Other data types (string, int) do not trigger this issue
• The issue appears to be in how Livewire's JavaScript serializes boolean values and how the PHP hydration layer processes them
• I've totally removed Volt with other applications, and still getting the same error.

Full Error Stack Trace

Livewire\Exceptions\MissingRulesException: Missing [$rules/rules()] property/method on: [pages.auth.login].

at Livewire\Volt\Component@anonymous C:\path\to\storage\framework\views\livewire\classes\69ca4bd9.php:18

   15▕     public function login(): void
   16▕     {
   17▕         // Validate using the Livewire Form rules/attributes
➜  18▕         $this->form->validate();
   19▕
   20▕         $this->form->authenticate();
   21▕
   22▕         Session::regenerate();

Request Payload (from Browser)

When the error occurs, the Livewire HTTP POST to /livewire/update contains:

{
    "_token": "...",
    "components": [
        {
            "snapshot": "{...}",
            "updates": {
                "form": {
                    "email": "user@example.com",
                    "password": "password",
                    "remember": true  // ← This boolean true triggers the bug
                }
            },
            "calls": [
                {
                    "method": "login",
                    "params": []
                }
            ]
        }
    ]
}

Suggested Fix Area

The issue likely resides in one of these areas:

1. Livewire's validation rule resolver - When resolving rules for nested Form objects during hydration
2. Volt's component compilation - How Volt generates the component class and handles Form objects
3. Livewire's property hydration - How boolean values are processed during component state restoration

The bug specifically involves the interaction between:

• Volt anonymous component classes
• Nested Livewire Form objects
• Boolean property updates from JavaScript
• Validation rule resolution during HTTP request hydration

This indicates the bug is specifically in Livewire's JavaScript→PHP hydration layer when handling serialized component state from actual HTTP requests, not in the core validation logic itself.

How do you expect it to work?

Authentication flow should work, and tests should reflect the error.

Thank you.

Please confirm (incomplete submissions will not be addressed)

• I have provided easy and step-by-step instructions to reproduce the bug.
• I have provided code samples as text and NOT images.
• I understand my bug report will be removed if I haven't met the criteria above.

[joshhanley]

@amoktar thanks for reporting! This is a duplicate of #9860 so I'm going to close this. I've also already submitted a PR #9876 to fix this.