Hono

軽量かつCloudflare Workersに完全に対応している便利なフレームワークです。

これがでてからNest.jsは使うことがなくなりました。

で、今回はHonoを使っていて「これってどうやるのかな」と思ったことについてまとめます。

エラー処理

hono + openapi-zod-clientを利用していると入力値のバリデーションにコケた場合にZodErrorが発生します。で、これはこれでいいのですが、この時点で勝手に400 BadRequestが返ってしまい、

1
app.onError(async (error, c) => {
2
  if (error instanceof HTTPException) {
3
    return c.json({ message: error.message }, error.status)
4
  }
5
  if (error instanceof ZodError) {
6
    return c.json({ message: error.message, description: error.cause }, 400)
7
  }
8
  return c.json({ message: error.message }, 500)
9
})

こう書いたときのこの処理が実行されません。

それでは困るのでdefaultHookで対応します。

1
const app = new Hono<{ Bindings: Bindings }>({
2
  defaultHook: (result) => {
3
    if (!result.success) {
4
      throw result.error
5
    }
6
  }
7
})

こんな感じで設定します。

するとちゃんとエラーがとんできます。このときdefaultHookは必ずバリデーションエラーが発生するHonoインスタンスに対してつけてください。

Prisma

Cloudflare WorkersではPrisma以外を使うのがいいみたいなんですが、クエリの書き方がこれが一番好きなのでまだ愛用しています。

WorkersはエッジサーバーなのでPrismaを都度初期化していると大変コストがかかってしまうのでCPU時間が足りません。そのためにいろいろ苦労されているみたいです。

1
import { PrismaClient } from '@prisma/client'
2

3
type Bindings = {
4
  prisma: PrismaClient
5
}
6

7
const prisma = new PrismaClient()
8
app.use('*', async (c: Context<{ Bindings: Bindings }>, next) => {
9
  c.env.prisma = prisma
10
  await next()
11
})

こういう感じで定義しておいて、グローバルにprismaを一回だけ初期化しておけば、そのインスタンスを使い回すことができます。

HonoのインスタンスにもBindingsで渡してあげればTypeScriptの型を利用してc.env.prismaとしてDBへのアクセスができるようになります。

マイグレーション

以前、DBのマイグレーションを何もわかっていなかったので都度、migrationsディレクトリをふっとばして不整合を起こしていましたが、migrationsディレクトリは消さないほうがいいです（戒め）

Docker

Honot + PrismaのアプリケーションをDockerイメージにするとき、気をつけなければいけないことがあります。

それは、イメージが立ち上がったときにイメージ内にあるmigrationsを元に、DBのマイグレーションを実行しなければいけないということです。

そうでないとアプリケーション定義とDBの間に齟齬が生じて、エラーが発生します。

つまり、コンテナが立ち上がるとprisma migrate deployを実行したいが、bun dist/index.jsもしたいわけです。DockerfileにCMDは一つしか書けないのでこれは困ります。

Dockerfile

1
ARG BUN_VERSION=1.2.9
2

3
FROM oven/bun:${BUN_VERSION} AS build
4
WORKDIR /app
5

6
COPY . .
7
RUN bun install --frozen-lockfile --ignore-scripts --silent --production
8
RUN bunx prisma generate
9
RUN bun run build
10

11
FROM oven/bun:${BUN_VERSION}-slim
12
ENV NODE_ENV=production
13
WORKDIR /app
14

15
COPY --from=build /app/node_modules node_modules
16
COPY --from=build /app/dist dist
17
COPY --from=build /app/prisma prisma
18
COPY --from=build /app/entrypoint.sh /entrypoint.sh
19

20
RUN chmod +x /entrypoint.sh
21

22
ENTRYPOINT [ "/entrypoint.sh" ]
23
CMD ["bun", "dist/index.js"]

というDockerfileと、以下のようなentrypoint.shを用意します。

1
#!/bin/sh
2

3
bunx prisma migrate deploy
4

5
exec "$@"

このentrypoint.shがポイントで、実行後にCMDが実行されます。よって、マイグレーションしてからサービスを立ち上げることができるようになります。

すると新しくイメージを引っ張ってきて立ち上げ直すだけでいいよ、楽ですね。

まとめ

Honoは奥深い。

Honoを利用するときに忘れがちなこと