HonoでConnect RPCを動かす
こんにちは、@sugar235711です。
この記事は「Hono Advent Calendar 2025」15日目の記事です。
はじめに
HonoのNode.js Adapterを使うと、HTTP/2通信を行うサーバーを簡単に立ち上げることができます。
import { createServer } from 'node:http2'
const server = serve({
fetch: app.fetch,
createServer,
})
なのでHonoで立ち上げたNode.jsサーバー上でConnect RPCを使ったgRPC互換のサーバー動かせますよね。ということで試しました。
検証用のコードは↓
Connect RPCについて
Connect RPCは、gRPC/gRPC-Web/Connect Protocolの3つのプロトコルで通信できるRPCフレームワークです。TypeScript/JavaScriptをはじめ、Go、Python、Java、C#等様々な言語で利用可能です。
Protocol Buffersを使用してスキーマ定義し、型安全なRPC通信を実現します。
この記事はHonoの記事なのでこれ以上は割愛します。
筆者のConnect RPC関連記事
connect-es編
connect-go から学ぶコード生成
gRPCとフロントエンド_Connectを添えて
Hono用ミドルウェアの作成
HonoでConnect RPCを使うために、honoConnectMiddlewareを作成します。Express用のミドルウェアを参考に実装しています。
ポイントは以下の通りです。
・Node.jsリクエスト/レスポンスの変換: universalRequestFromNodeRequestとuniversalResponseToNodeResponseを使用して、HonoのNode.js環境とConnect RPCのUniversal Handlerを橋渡しの実装
・コンテキストの受け渡し: HonoのContextをConnect RPCのContextに渡すための仕組みの実装
Node.jsリクエスト/レスポンスの変換
HonoのNode.js Adapterでは、incoming/outgoingでリクエスト/レスポンスを扱います。
Connect RPCのUniversal Handlerと連携するには、これらを変換する必要があります。Connect側が提供するuniversalRequestFromNodeRequestとuniversalResponseToNodeResponseを使って変換を行います。
コンテキストの受け渡し
利用側は簡単で、Connect RPC用のRouterを作成してミドルウェアに渡すだけです。
const honoContextKey = createHonoContextKey<HonoEnv>();
const app = new Hono<HonoEnv>();
app.use("*", requestId());
// Connect RPC エンドポイント
app.use(
"/connectrpc*",
honoConnectMiddleware({
honoContextKey,
routes(router: ConnectRouter) {
router.service(ElizaService, {
say(req: SayRequest, ctx) {
// HonoのContextからrequestIdを取得
const honoCtx = ctx.values.get(honoContextKey);
const reqId = honoCtx?.get("requestId");
return create(SayResponseSchema, {
sentence: `You said: "${req.sentence}" (requestId: ${reqId})`,
});
},
});
},
})
);
// 通常のRESTエンドポイント
app.get("/", (c) => c.text("Hello Hono with Connect RPC over HTTP/2!"));
app.get("/api/users", (c) => c.json({ users: [{ id: 1, name: "John" }] }));
そのままだとConnect RPCのRouter側にHonoのContextが渡せないので、createHonoContextKeyというSymbolを使ってHonoのContextをConnectのContextに渡しています。
export function createHonoContextKey<E extends Env>() {
return createContextKey<Context<E> | undefined>(undefined);
}
これによりHonoのミドルウェアで設定した値(例:requestId)をConnect RPCのサービス実装側で取得できるようにします。
HTTP/2サーバーの起動
あとは適当に証明書を用意してサーバーを立ち上げれば、HTTP/2での通信が可能になります。
serve({
fetch: app.fetch,
port: 3000,
createServer: createSecureServer,
serverOptions: {
key: readFileSync("certs/server.key"),
cert: readFileSync("certs/server.crt")
},
});
Connect Protocol(JSON)での通信
$ curl -k -v --http2 https://localhost:3000/connectrpc.eliza.v1.ElizaService/Say \
-H "Content-Type: application/json" \
-d '{"sentence": "Hello!"}'
* using HTTP/2
* [HTTP/2] [1] OPENED stream for https://localhost:3000/connectrpc.eliza.v1.ElizaService/Say
> POST /connectrpc.eliza.v1.ElizaService/Say HTTP/2
> Content-Type: application/json
< HTTP/2 200
< content-type: application/json
{"sentence":"You said: \"Hello!\" (requestId: 57a7bfde-12c0-49fd-bb4d-dd0994fd241a)"}
gRPCプロトコルでの通信
gRPC互換なのでcontent-type: application/grpc+protoでの通信も可能です。
$ grpcurl \
-insecure \
-protoset eliza.protoset \
-d '{"sentence":"Hello!"}' \
localhost:3000 \
connectrpc.eliza.v1.ElizaService/Say
{
"sentence": "You said: \"Hello!\" (requestId: dd1b21d6-7c36-4df5-91e5-dd0ac9e497d0)"
}
unaryのみしか試してないですが、Node.jsサーバーならStreamingも動作するはずです。
もちろん既存のHono APIと共存できるため、ソフトウェアレイヤーでの REST APIとgRPCのゲートウェイサーバーとして利用できたり、gRPC Webとも互換があるので何も考えず(???)にブラウザでも使えます。
まとめ
HonoとConnect RPCを組み合わせて開発ができます。
Discussion