PHP WeakMap 为什么对象销毁后键会自动消失

WeakMap 的键会在对象销毁后自动消失，根本原因是：这个键不会增加对象的引用计数。只要业务变量、容器、闭包或其他属性都不再持有该对象，WeakMap 本身不会为了保留缓存条目而阻止对象被回收；对象被回收时，对应键值条目也会被移除。

官方资料：https://www.php.net/manual/en/class.weakmap.php

WeakMap 适合保存“依附于对象、可随时重建”的派生数据。它解决的是缓存寿命比业务对象更长的问题，不适合保存订单状态、权限结果等不能丢失的权威数据。

WeakMap 保护的是对象生命周期边界

PHP 对象变量保存的是可定位对象的标识。把对象赋给另一个变量，两个变量都会指向同一个对象。普通容器通常会形成强引用，因此即使业务变量已经释放，容器仍可能让对象继续存活。

WeakMap 的不同之处是，作为键放进去的对象不增加引用计数。PHP 官方手册明确说明：当 WeakMap 键成为对象的唯一剩余引用时，对象会被垃圾回收，并从 WeakMap 删除。这使缓存条目的寿命天然不超过键对象。

用 WeakMap 缓存对象的派生元数据

下面的示例给文档对象缓存一次计算得到的摘要。摘要可以重新计算，所以它适合跟随对象一起消失。

 */
    private WeakMap $items;

    public function __construct()
    {
        // WeakMap 只接受对象作为键
        $this->items = new WeakMap();
    }

    public function get(Document $document): string
    {
        if (!isset($this->items[$document])) {
            // 值是可重建的派生数据，不是业务事实
            $this->items[$document] = mb_substr($document->body, 0, 20);
        }

        return $this->items[$document];
    }

    public function count(): int
    {
        // count 只统计当前仍存活的条目
        return count($this->items);
    }
}

对象仍被调用方持有时，缓存可以正常命中。WeakMap 并不是“立刻丢数据”的容器，它只是拒绝成为延长键对象寿命的理由。

最后一个强引用消失后发生了什么

用一个最小调用即可观察边界。代码块中的输出只是预期说明，不把它冒充本机运行证据。

get($document);
echo $cache->count() . "\n";

// 删除最后一个外部强引用；WeakMap 键不会阻止对象回收
unset($document);

// 对于这里没有引用环的对象，条目会随对象释放而消失
echo $cache->count() . "\n";

在这个无引用环示例中，释放变量后引用计数可以立即归零，因此析构方法执行，WeakMap 条目也随之消失。若对象参与引用环，回收可能依赖 PHP 的循环垃圾回收机制；所以工程代码应依赖“条目最终不再存活”的语义，而不是把某个精确时刻当成业务事件。

键没有消失时先排查隐藏强引用

WeakMap 中仍能看到对象，不等于 WeakMap 失效。更常见的原因是还有其他位置持有对象：

• 对象仍在普通数组、SplObjectStorage 或队列中；
• 闭包通过 use 捕获了对象；
• 服务对象的属性、静态属性或全局变量保存着对象；
• 另一个对象引用它，或者双方组成引用环；
• 调试代码本身把对象保存到临时集合中。

排查时应从“谁还拥有这个对象”入手，而不是对 WeakMap 手工反复 unset。如果确实需要立即撤销某条缓存，也可以显式执行 unset($map[$object])，但那是业务主动失效，不是弱键机制的必要步骤。

不要让缓存值反过来承担对象所有权

一个安全的设计原则是：WeakMap 的值只保存字符串、数字、不可变描述或与键对象生命周期无关的结果。不要让缓存值承担管理键对象的职责，也不要把必须可靠保存的数据只放在 WeakMap 中。

检查清单

1. 确认运行环境是 PHP 8 或更高版本。
2. 确认键是对象，缓存值可由该对象重新计算。
3. 确认没有普通容器、闭包或静态属性继续持有键对象。
4. 用 count() 观察存活条目，不把回收瞬间用于业务控制。
5. 需要稳定保存的数据继续写入数据库、文件或普通缓存。

相关问题

WeakMap 的键可以是字符串吗？

不可以。WeakMap 接受对象作为键；字符串、整数等标量应使用普通数组或其他缓存结构。

unset 对象变量后条目一定同步消失吗？

没有其他引用且不存在引用环时，引用计数归零通常会立即释放。涉及引用环时，具体回收时间可能依赖循环垃圾回收，因此不要把时点当成业务承诺。

WeakMap 和 SplObjectStorage 最大区别是什么？

两者都能以对象关联数据，但 SplObjectStorage 会持有对象；WeakMap 的键不增加对象引用计数，所以不会仅为了条目而延长对象寿命。

可以遍历 WeakMap 吗？

可以，WeakMap 实现了可遍历与可计数接口。但遍历结果只反映当时仍存活的条目，不应被当成永久对象清单。

一句话总结：对象是否存活由外部强引用决定，WeakMap 只跟随，不挽留。正因为键不增加引用计数，它才适合做不会泄漏对象生命周期的派生数据缓存。