Vue Storefront 项目中的 Liveness Probes 健康检查机制详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00250/article/details/148415143

Vue Storefront 项目中的 Liveness Probes 健康检查机制详解

vue-storefront The open-source frontend for any eCommerce. Built with a PWA and headless approach, using a modern JS stack. We have custom integrations with Magento, commercetools, Shopware and Shopify and total coverage is just a matter of time. The API approach also allows you to merge VSF with any third-party tool like CMS, payment gateways or analytics. Newest updates: https://blog.vuestorefront.io. Always Open Source, MIT license. 项目地址: https://gitcode.com/gh_mirrors/vu/vue-storefront

什么是 Liveness Probes

在 Kubernetes 环境中部署 Vue Storefront 应用时，Liveness Probes（存活探针）是一种关键的自我修复机制。它通过定期检查应用的运行状态，确保应用能够持续正常提供服务。

核心作用

自动检测应用崩溃：当应用进程意外退出时（如启动失败、内存不足等），系统能够立即感知
解决死锁问题：当应用因代码缺陷进入死循环或无响应状态时，探针会触发重启
维持服务可用性：确保应用即使在部分功能异常时也能保持基本可用性

Vue Storefront 中的实现原理

Vue Storefront 项目通过 /healthz 端点实现存活检查，这是一个轻量级的 HTTP 接口，只需返回简单的 200 状态码和 "ok" 响应即可。

为什么选择简单端点

性能考量：复杂检查会增加系统负载，特别是在高并发时
可靠性：简单端点响应更快，避免因检查本身导致的问题
专注核心功能：存活检查应关注应用是否运行，而非完整功能验证

不同技术栈的实现方式

1. 中间件实现（默认支持）

Vue Storefront 中间件从 3.0.0 版本开始默认提供 /healthz 端点：

访问地址：http://localhost:4000/healthz
预期响应：HTTP 200 状态码 + "ok" 文本

2. Nuxt 前端实现

对于基于 Nuxt 的前端应用，创建专用端点：

// server/routes/healthz.ts
export default defineEventHandler(() => 'ok');

3. Next.js 实现（App Router）

使用 Next.js 的应用路由模式：

// app/healthz/route.ts
import { NextResponse } from 'next/server';

export function GET() {
  return NextResponse.json({ status: 'ok' }, { status: 200 });
}

4. Next.js 实现（Pages Router）

传统页面路由模式需要额外配置：

// next.config.js
module.exports = {
  async rewrites() {
    return [{ source: '/healthz', destination: '/api/healthz' }];
  }
}

// pages/api/healthz.ts
import { NextApiRequest, NextApiResponse } from 'next';

export default function handler(_req: NextApiRequest, res: NextApiResponse) {
  res.status(200).send('ok');
}