Laravel 10.x集合中部分加密属性解密异常问题求助

核心问题 #

你遇到的属性解密不一致问题，是Laravel从5.2升级到10.x后，模型属性序列化逻辑、访问器缓存机制变化导致的：

1. 原访问器直接读取$this->attributes里的原始加密值，绕过了Laravel的属性缓存机制——只有主动访问过的属性，才会在集合中显示解密后的值；未被主动访问的normalEmail，序列化时仍输出原始加密值。
2. normalTel无需添加$appends就能正常显示解密值，大概率是代码其他环节（比如循环外逻辑、模型其他方法）提前访问过该属性，Laravel已将解密结果缓存到模型中；而把它加入$appends后触发重复解密异常，是因为访问器每次都直接解密原始值，没有利用缓存，导致对已解密的字符串再次调用Crypt::decrypt。

解决方案 #

方案一：改用Laravel内置加密列处理（推荐）

从Laravel 6+开始支持直接通过$casts标记加密列，自动处理加密/解密、缓存和序列化，无需手动编写访问器：

// 在User模型中添加
protected $casts = [
    'normalEmail' => 'encrypted',
    'normalTel' => 'encrypted',
];

如果需要保留原有的异常处理（解密失败返回UNAVAILABLE并记录日志），可以用Laravel 9+的Attribute类自定义访问器：

use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Contracts\Encryption\DecryptException;
use Illuminate\Support\Facades\Log;

class User extends Model
{
    private const UNAVAILABLE = 'N/A'; // 替换为你实际的UNAVAILABLE值

    protected function normalEmail(): Attribute
    {
        return Attribute::make(
            get: function ($value) {
                if (empty($value)) {
                    return self::UNAVAILABLE;
                }
                try {
                    return Crypt::decrypt($value, true);
                } catch (DecryptException $e) {
                    Log::warning("Error while decrypting normal email {$value}: {$e->getMessage()}");
                    return self::UNAVAILABLE;
                }
            },
            set: function ($value) {
                return Crypt::encrypt($value, true);
            }
        )->shouldCache(); // 开启缓存，避免重复解密
    }

    protected function normalTel(): Attribute
    {
        return Attribute::make(
            get: function ($value) {
                if (empty($value)) {
                    return self::UNAVAILABLE;
                }
                try {
                    return Crypt::decrypt($value, true);
                } catch (DecryptException $e) {
                    Log::warning("Error while decrypting normal tel {$value}: {$e->getMessage()}");
                    return self::UNAVAILABLE;
                }
            },
            set: function ($value) {
                return Crypt::encrypt($value, true);
            }
        )->shouldCache();
    }
}

这种写法完全符合Laravel新版本规范，自动处理序列化、缓存和异常，不会出现属性显示不一致的问题。

方案二：修复现有访问器逻辑

如果想保留原访问器结构，需修改访问器利用传入的$value参数，让Laravel正确处理属性缓存：

use Illuminate\Contracts\Encryption\DecryptException;
use Illuminate\Support\Facades\Log;

public function getNormalEmailAttribute($value)
{
    $text = self::$UNAVAILABLE;
    try {
        // 直接使用传入的$value，而非读取$this->attributes
        $text = Crypt::decrypt($value, true);
    } catch (DecryptException $e) {
        Log::warning("Error while decrypting normal email {$value}: {$e->getMessage()}");
    }

    Log::info("EMail (returned value) is {$text}");
    return $text;
}

public function getNormalTelAttribute($value)
{
    $text = self::$UNAVAILABLE;
    try {
        $text = Crypt::decrypt($value, true);
    } catch (DecryptException $e) {
        Log::warning("Error while decrypting normal tel {$value}: {$e->getMessage()}");
    }

    return $text;
}

修改后，Laravel会自动缓存访问器返回的解密值，后续访问或序列化时直接使用缓存值，不会重复解密，也无需添加$appends就能让两个属性在集合中显示解密后的值。

额外说明 #

• 原normalEmail访问器中有一行无效代码：("Error while decrypting normal email " . $encryptedValue . " : " . $e->getMessage());，建议删除以避免冗余。
• Laravel 5.2到10.x的属性处理逻辑变化较大，尽量使用新版本推荐写法，减少兼容性问题。

内容的提问来源于stack exchange，提问作者HelloWorld