Eloquent 属性不能返回 CompletableFuture，因其访问器/修改器严格同步执行，不支持协程、await 或 Promise；替代方案是显式定义普通方法配合缓存与错误处理。
PHP 里没有 CompletableFuture，Laravel Eloquent 也没有原生的“异步属性”或“未来值”机制 —— 所有试图把 Java 的 CompletableFuture 概念直接套到 Eloquent 上的做法，都会在运行时失败或产生不可预测的延迟/竞态。
为什么 Eloquent Attribute 不能返回 CompletableFuture
Eloquent 的访问器（accessor）和修改器（mutator）是同步执行的：当你读取 $model->name 或赋值 $model->price = 19.99，PHP 立即调用对应 getXXXAttribute() 或 setXXXAttribute() 方法。它不支持 await、Promise、协程挂起，也不认识 Java 风格的 CompletableFuture.supplyAsync()。
- 尝试在 accessor 中返回
new CompletableFuture()—— PHP 会报Class 'CompletableFuture' not found - 试图在 accessor 中写
async/await（如 Swoole 协程）—— Eloquent 不会等待，直接返回 null 或未解析值 - 把耗时逻辑（如 HTTP 请求、队列任务 ID 查询）塞进 accessor —— 会导致 N+1 查询、响应阻塞、无法缓存
替代方案：用 lazy loading + 缓存 + 显式触发
真正可行的“延迟计算属性”，靠的是**显式调用 + 结果缓存**，而不是幻想模型自动 resolve 一个“未来”。常见于需要关联远程服务、聚合计算、或防重复查询的场景。
- 定义一个普通方法（非 accessor），比如
getCalculatedPriceAsync()，内部用Http::timeout(5)->get(...)或Cache::remember(...) - 在控制器或服务类中按需调用，并自行处理失败重试或 fallback：
$price = $product->getCalculatedPriceAsync() ?? $product->base_price; - 若需“一次触发、多次读取”，在模型内加私有属性缓存结果：
private ?float $cached_calculated_price = null;，方法内判断是否已计算 - 避免在
toArray()、jsonSerialize()或 Blade 模板中隐式调用这类方法 —— 它们不会被自动 eager loaded，且无上下文控制超时/错误
Laravel 10+ 中可考虑的轻量协程支持（仅限 Swoole / RoadRunner）
如果你已部署在 Swoole 环境下，且启用了 Laravel 的协程支持（php artisan swoole:http start），可以用 co::run() 包裹异步 I/O，但依然不能让 Eloquent 属性“自动 await”。
立即学习“PHP免费学习笔记（深入）”；
// ✅ 可行：在服务类中显式协程化
use Swoole\Coroutine;
public function fetchRemoteData()
{
return Coroutine\run(function () {
$result = Http::get('https://api.example.com/price');
return $result->json()['value'] ?? 0;
});
}
// ❌ 不可行：放在 accessor 里
public function getRemotePriceAttribute()
{
// 这里 co::run 不会被 Eloquent 等待，返回的是协程对象，不是数值
return co::run(fn() => Http::get(...)->json()['value']);
}
容易被忽略的关键点
很多人卡在“为什么我加了 cache 还是慢”，其实问题不在缓存本身，而在调用时机和作用域：
-
Cache::remember()的 key 必须包含模型唯一标识（如product:{$this->id}:calculated_price），否则多个模型共享同一缓存项 - 不要在
with()关系预加载里试图“预加载异步属性”——Eloquent 不支持，会静默跳过 - 如果该“未来值”依赖当前用户权限（如价格含会员折扣），缓存 key 还得带上
auth()->id()，否则出现缓存污染 - 日志和异常必须显式捕获，异步失败不会中断请求，但也不会自动 fallback —— 不处理就变成空值或 500
