Hono v4.7.0 发布：新增代理助手、国际化中间件和JWK认证中间件

Hono 是一个轻量级的 JavaScript Web 框架，专为现代 Web 开发而设计。它以简洁、高效和灵活著称，特别适合构建 API 和微服务。Hono 支持多种运行时环境，包括多种云服务、Deno、Bun 和 Node.js 等，使其成为跨平台开发的理想选择。

最新发布的 Hono v4.7.0 版本带来了几个重要的新功能和改进，包括代理助手、国际化中间件和 JWK 认证中间件等。这些新特性进一步扩展了 Hono 的功能边界，为开发者提供了更多便利。

代理助手：简化反向代理实现

在 Web 开发中，反向代理是一个常见的需求。Hono v4.7.0 引入了一个全新的代理助手，极大地简化了反向代理的实现过程。

传统上，在使用 Hono 作为反向代理时，开发者需要直接使用 fetch API 来访问后端服务。但这种方式存在一些问题，比如会发送一些不必要的头部信息（如 Accept-Encoding），可能导致后端返回压缩响应，而某些运行时会自动解压缩这些响应，从而导致 Content-Length 不匹配等问题。

新的代理助手解决了这些问题。它不仅能正确处理请求和响应，还能自动处理各种边缘情况。使用起来非常简单：

import { proxy } from 'hono/proxy'

app.get('/proxy/:path', (c) => {
  return proxy(`http://${originServer}/${c.req.param('path')}`)
})

对于更复杂的需求，开发者还可以自定义请求头和处理响应：

app.get('/proxy/:path', async (c) => {
  const res = await proxy(
    `http://${originServer}/${c.req.param('path')}`,
    {
      headers: {
        ...c.req.header(),
        'X-Forwarded-For': '127.0.0.1',
        'X-Forwarded-Host': c.req.header('host'),
        Authorization: undefined,
      },
    }
  )
  res.headers.delete('Set-Cookie')
  return res
})

国际化中间件：轻松实现多语言支持

随着全球化的发展，多语言支持已成为现代 Web 应用的标配。Hono v4.7.0 新增的语言中间件让国际化实现变得轻而易举。

该中间件提供了 languageDetector 功能，可以自动检测用户偏好的语言。它支持多种检测方式：

• 查询参数
• Cookies
• Accept-Language 头部
• URL 路径

使用示例：

import { languageDetector } from 'hono/language'

app.use(
  languageDetector({
    supportedLanguages: ['en', 'ar', 'ja'], // 支持的语言列表，必须包含回退语言
    fallbackLanguage: 'en', // 必填的回退语言
  })
)

app.get('/', (c) => {
  const lang = c.get('language')
  return c.text(`Hello! Your language is ${lang}`)
})

JWK 认证中间件：安全的身份验证方案

安全性是现代 Web 应用的重要考量。Hono v4.7.0 新增的 JWK (JSON Web Key) 认证中间件为开发者提供了一种安全的身份验证方案。

该中间件可以验证 JWK 令牌，并从指定 URL 获取密钥。使用起来非常简单：

import { jwk } from 'hono/jwk'

app.use(
  '/auth/*',
  jwk({
    jwks_uri: `https://${backendServer}/.well-known/jwks.json`,
  })
)

app.get('/auth/page', (c) => {
  return c.text('You are authorized')
})

标准 Schema 验证器：统一的验证接口

除了上述主要功能外，Hono 生态系统还新增了 Standard Schema 验证器。这是一个统一的验证接口，支持多种流行的验证库，包括 Zod、Valibot 和 ArkType 等。

使用示例展示了其强大的兼容性：

import { sValidator } from '@hono/standard-validator'
import { type } from 'arktype'
import * as v from 'valibot'
import { z } from 'zod'

const aSchema = type({ agent: 'string' })
const vSchema = v.object({ slag: v.string() })
const zSchema = z.object({ name: z.string() })

app.get(
  '/:slag',
  sValidator('header', aSchema),
  sValidator('param', vSchema),
  sValidator('query', zSchema),
  (c) => {
    const headerValue = c.req.valid('header')
    const paramValue = c.req.valid('param')
    const queryValue = c.req.valid('query')
    return c.json({ headerValue, paramValue, queryValue })
  }
)

其他改进

除了上述主要功能外，Hono v4.7.0 还包含了一些其他改进：

• 日志记录现在包含查询参数
• 上下文对象新增 buffer 返回支持
• ETag 中间件现在支持自定义哈希方法
• 路由器优化，支持贪婪匹配与后续静态组件的组合

这些改进进一步提升了 Hono 的实用性和灵活性，使其能够更好地满足各种 Web 开发需求。

Hono 框架持续演进，v4.7.0 版本的发布再次证明了其作为现代 JavaScript Web 框架的活力和创新精神。无论是构建简单的 API 还是复杂的 Web 应用，Hono 都提供了强大而灵活的工具集。