大型项目路由组织

// src/routes/users/routes.ts
import { Hono } from 'hono'
import { listUsers, getUser, createUser, updateUser, deleteUser } from './handlers'
 
const users = new Hono()
 
users.get('/', listUsers)
users.get('/:id', getUser)
users.post('/', createUser)
users.put('/:id', updateUser)
users.delete('/:id', deleteUser)
 
export default users

// src/routes/users/handlers.ts
import type { Context } from 'hono'
import { userService } from './services'
 
export const listUsers = async (c: Context) => {
  const users = await userService.findAll()
  return c.json({ users })
}
 
export const getUser = async (c: Context) => {
  const id = c.req.param('id')
  const user = await userService.findById(id)
  if (!user) {
    return c.json({ error: 'User not found' }, 404)
  }
  return c.json(user)
}

// src/routes/users/index.ts
export { default } from './routes'

// src/routes/index.ts
import { Hono } from 'hono'
import { authMiddleware } from '@/middleware/auth'
import { adminMiddleware } from '@/middleware/admin'
 
// 公开路由
import authRoutes from './auth/routes'
import healthRoutes from './health/routes'
 
// 认证路由
import usersRoutes from './users/routes'
import contentRoutes from './content/routes'
import billingRoutes from './billing/routes'
 
// 管理员路由
import adminUsersRoutes from './admin/users/routes'
import adminContentRoutes from './admin/content/routes'
import adminBillingRoutes from './admin/billing/routes'
 
const app = new Hono().basePath('/api/v1')
 
// 公开路由 — 不挂载认证中间件
app.route('/auth', authRoutes)
app.route('/health', healthRoutes)
 
// 认证路由 — 挂载认证中间件
const authenticated = new Hono().use('*', authMiddleware)
authenticated.route('/users', usersRoutes)
authenticated.route('/content', contentRoutes)
authenticated.route('/billing', billingRoutes)
app.route('/', authenticated)
 
// 管理员路由 — 挂载认证 + 管理员权限中间件
const admin = new Hono()
  .use('*', authMiddleware)
  .use('*', adminMiddleware)
admin.route('/users', adminUsersRoutes)
admin.route('/content', adminContentRoutes)
admin.route('/billing', adminBillingRoutes)
app.route('/admin', admin)
 
export default app

// src/routes/index.ts
import { Hono } from 'hono'
import { authMiddleware } from '@/middleware/auth'
import { adminMiddleware } from '@/middleware/admin'
 
// 按层导入
import { publicRoutes } from './public'
import { authenticatedRoutes } from './authenticated'
import { adminRoutes } from './admin'
 
export function createRouter() {
  const app = new Hono().basePath('/api/v1')
 
  app.route('/', publicRoutes)
 
  const auth = new Hono().use('*', authMiddleware)
  auth.route('/', authenticatedRoutes)
  app.route('/', auth)
 
  const admin = new Hono()
    .use('*', authMiddleware)
    .use('*', adminMiddleware)
  admin.route('/', adminRoutes)
  app.route('/admin', admin)
 
  return app
}
 
export default createRouter()

// src/routes/authenticated/index.ts
import { Hono } from 'hono'
import usersRoutes from '../users/routes'
import contentRoutes from '../content/routes'
import billingRoutes from '../billing/routes'
import aiRoutes from '../ai/routes'
import notificationRoutes from '../notifications/routes'
 
const authenticatedRoutes = new Hono()
 
authenticatedRoutes.route('/users', usersRoutes)
authenticatedRoutes.route('/content', contentRoutes)
authenticatedRoutes.route('/billing', billingRoutes)
authenticatedRoutes.route('/ai', aiRoutes)
authenticatedRoutes.route('/notifications', notificationRoutes)
 
export { authenticatedRoutes }

// src/routes/content/routes.ts
import { Hono } from 'hono'
import type { RouteMeta } from '@/types/route-meta'
 
const content = new Hono()
 
// 在 handler 链中通过 c.set() 传递元数据
content.get('/articles', async (c, next) => {
  c.set('meta', {
    description: '获取文章列表',
    requiresAuth: true,
    rateLimit: { max: 100, window: '1m' },
  } satisfies RouteMeta)
  await next()
}, listArticles)
 
content.get('/articles/:id', async (c, next) => {
  c.set('meta', {
    description: '获取单篇文章',
    requiresAuth: false,
    rateLimit: { max: 200, window: '1m' },
  } satisfies RouteMeta)
  await next()
}, getArticle)
 
export default content

// src/middleware/rate-limit.ts
import type { RouteMeta } from '@/types/route-meta'
 
export const rateLimitMiddleware = async (c, next) => {
  const meta = c.get('meta') as RouteMeta | undefined
  if (!meta?.rateLimit) {
    await next()
    return
  }
  // 根据 meta.rateLimit 执行限流逻辑
  // ...
  await next()
}

// src/routes/index.ts
import { Hono } from 'hono'
import { env } from '@/config/env'
 
export function createRouter() {
  const app = new Hono().basePath('/api/v1')
 
  // 所有环境都挂载的路由
  app.route('/auth', authRoutes)
  app.route('/users', usersRoutes)
 
  // 仅开发/测试环境
  if (env.NODE_ENV !== 'production') {
    const devRoutes = new Hono()
    devRoutes.post('/seed', seedData)
    devRoutes.get('/debug/routes', listRegisteredRoutes)
    devRoutes.post('/mock/external/:service', mockExternalService)
    app.route('/dev', devRoutes)
  }
 
  return app
}

// src/routes/users/routes.ts — 错误示范
const users = new Hono()
users.get('/users', listUsers)     // 注意这里写了 /users
users.get('/users/:id', getUser)
export default users
 
// src/routes/index.ts
app.route('/users', users)
// 最终路径：GET /users/users — 前缀重复了

// src/routes/users/routes.ts — 正确写法
const users = new Hono()
users.get('/', listUsers)          // 相对于挂载点的路径
users.get('/:id', getUser)
export default users

// 错误：authMiddleware 会拦截公开路由
app.use('*', authMiddleware)
app.route('/auth', authRoutes)  // 登录接口也要认证？