不该用中间件实现。页面静态化需在控制器中调用view()->fetch()获取HTML字符串，再写入public/static/下对应.html文件并exit，中间件无法安全终止渲染流程且易导致双输出、头信息错误等问题。
页面静态化缓存该不该用中间件实现
不应该。ThinkPHP 的页面静态化（即生成 .html 文件供 Nginx/Apache 直接返回）本质是「响应写入文件 + 跳过后续执行」，而中间件的职责是拦截请求/响应流、做预处理或后置处理，它无法安全终止模板渲染流程，更不能替代 view()->fetch() + file_put_contents() 这类主动输出控制。
正确做法：在控制器里手动触发静态化输出
核心逻辑是「先渲染模板为字符串，再写入 HTML 文件，最后直接输出并 exit」。中间件做不到这点，因为：view()->fetch() 必须在控制器或视图层调用；Response::create() 或 exit 一旦执行，中间件链已结束，无法反向干预。
- 只在需要缓存的控制器方法里做，比如
IndexController::index() - 检查缓存文件是否存在且未过期，用
is_file()+filemtime() - 缓存路径建议统一放在
public/static/下，避免权限问题，例如：public/static/index.html - 生成时务必用
view()->fetch('index')获取渲染后 HTML 字符串，别用view('index')（那是直接输出） - 写入前确保目录可写，否则
file_put_contents()静默失败
为什么不能靠中间件“劫持”输出内容
ThinkPHP 的中间件对响应体的修改能力有限：你可以在 AfterMiddleware 里拿到 $response->getContent()，但此时模板已经渲染完成、HTTP 头可能已发送，再写文件+替换响应体极易导致双输出、Content-Length 错误或空白页。
- 常见错误现象：
Warning: Cannot modify header information或页面部分渲染、乱码 -
$response->setContent()在中间件中调用后，仍会经过后续中间件和框架默认输出流程，无法保证原子性 - 静态化需精确控制「是否跳过渲染」，这只能在控制器入口判断，中间件太晚
- 性能上反而更差：每次请求都走完整生命周期，再提取内容，失去静态化本意
缓存更新与失效怎么配合路由参数
静态文件名必须能区分不同 URL 参数，否则 /user?id=1 和 /user?id=2 会共用一个缓存，造成数据错乱。
立即学习“PHP免费学习笔记（深入）”；
- 推荐用 URL path + query 参数的 MD5 哈希命名，例如：
md5(request()->url(true)) . '.html' - 不要只依赖
request()->param()，它不包含原始 query string 编码细节，会导致哈希不一致 - 更新缓存时，记得 unlink 旧文件，否则磁盘会被占满；可用
Cache::tag('page_static')->clear()配合自定义标签管理，但注意 tag 功能不自动清理文件系统 - 上线后首次访问会慢一点——这是正常现象，渲染+写入不可避免，后续才是纯静态响应
最易被忽略的是缓存路径的 Web 可访问性：确保 public/static/ 被 Web 服务器配置为可直接读取，且 PHP 进程有写权限；否则你看到的永远是 404 或 500，而不是缓存没生效。
