Laravel Octane 中的 Vite 预加载资产内存泄漏问题分析

问题背景

在 Laravel Octane 环境下使用 Vite 时，开发者发现了一个关于预加载资产的内存泄漏问题。这个问题特别影响多租户 SaaS 应用或需要服务多个域名的 Laravel 应用程序。

问题本质

问题的核心在于 Illuminate/Foundation/Vite.php 文件中的 $preloadedAssets 静态属性。这个数组用于存储预加载的资产，但在 Octane 的持久化进程中，它不会在每个请求之间自动重置，导致资产不断累积。

问题表现

当 Laravel 应用服务于多个域名时（例如 CMS SaaS 系统中每个客户使用自己的域名），Vite::preloadedAssets() 会逐渐积累所有域名的资产，而实际上它应该只包含当前请求域名的资产。这会导致：

1. 内存使用量持续增长
2. 错误的预加载头被发送到客户端
3. 潜在的安全问题（可能泄露其他租户的资产信息）

技术细节

AddLinkHeadersForPreloadedAssets 中间件依赖 Vite::preloadedAssets() 来生成正确的预加载头。当 $preloadedAssets 数组没有被正确重置时，中间件会为当前请求发送不属于该域名的预加载头。

解决方案

Laravel 核心团队通过以下方式修复了这个问题：

1. 在 Vite 服务类中添加了重置机制
2. 确保 $preloadedAssets 数组在每个请求开始时被清空
3. 保持预加载资产的作用域仅限于当前请求

对开发者的影响

对于大多数单域名应用，这个问题可能不会造成明显影响。但对于以下场景的开发者需要特别注意：

1. 多租户系统开发者
2. 使用自定义域名的 SaaS 应用开发者
3. 需要服务多个独立前端的后端开发者

最佳实践

即使这个问题已经在框架层面修复，开发者在编写 Octane 兼容代码时仍应注意：

1. 避免在服务类中使用静态属性存储请求级数据
2. 对于必须使用静态属性的情况，确保有适当的清理机制
3. 在多租户环境中，特别注意任何可能跨请求共享的状态

总结

这个问题的修复展示了 Laravel 团队对 Octane 环境下状态管理的持续改进。作为开发者，理解这类问题的本质有助于编写更健壮的 Octane 兼容代码，特别是在复杂的多域名或多租户环境中。