Skip to content

fix(hono): Name routes without c.req.matchedRoutes - #25454

Draft
s1gr1d wants to merge 8 commits into
developfrom
sig/hono-5--1
Draft

s1gr1d wants to merge 8 commits into
developfrom
sig/hono-5--1

Conversation

@s1gr1d

@s1gr1d s1gr1d commented Oct 16, 2026 •

Copy link
Copy Markdown
Member

On Hono 5, every request got the span name GET and an empty http.route. With this PR, names look the same as on Hono 4: GET /users/:id, with http.route set to /users/:id.

Why they broke:

  • Hono 5 removes c.req.matchedRoutes.
  • compose resets c.req.routeIndex after next() (honojs/hono#4424), so the Sentry middleware cannot see which handler responded.

How the name is built now:

  1. The Sentry middleware reads the match result through the getter that hono/route uses (matchResult.ts).
  2. Before the handlers run, it names the span after the first matched route handler, which is the one Hono runs first.
  3. Only if a route handler declares next (and can pass the request on), the SDK wraps the route handlers, so the handler that starts last renames the span.

Small changes on Hono 4 too: events captured in a handler get that handler's route (not a later catch-all), and a 404 keeps the runtime name GET instead of GET /*.

Refs #25223

Hono 5 removes c.req.matchedRoutes and c.req.routePath. The vendored HonoRequest type
required both, so app.use(honoMiddleware(app)) failed with TS2769 on Hono 5. Make
matchedRoutes optional and drop routePath, which the SDK does not read.

Add Vitest type tests against Hono 4 and a pinned Hono 5 release candidate, a type
check of the SDK calls in the Hono 4 E2E apps, and a lint rule that keeps hono
imports out of @sentry/server-utils. Pin the hono devDependency of @sentry/hono to
4.13.9, so the package no longer builds against the hoisted version by chance.

Refs #25223
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@s1gr1d
s1gr1d added this pull request to stack #25455 October 16, 2026 12:14
@github-actions

github-actions Bot commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

size-limit report 📦

⚠️ Warning: Base artifact is not the latest one, because the latest workflow run is not done yet. This may lead to incorrect results. Try to re-run all tests to get up to date results.

Path Size % Change Change
@sentry/browser 29.88 kB - -
@sentry/browser - with treeshaking flags 28.02 kB - -
@sentry/browser - with treeshaking flags tracing without tracing 27.92 kB - -
@sentry/browser (incl. Tracing) 52.07 kB - -
@sentry/browser (incl. Tracing + Span Streaming) 52.07 kB - -
@sentry/browser (incl. Tracing, Profiling) 55.02 kB - -
@sentry/browser (incl. Tracing, Replay) 91.82 kB - -
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags 80.68 kB - -
@sentry/browser (incl. Tracing, Replay with Canvas) 96.55 kB - -
@sentry/browser (incl. Tracing, Replay, Feedback) 109.49 kB - -
@sentry/browser (incl. Feedback) 47.4 kB - -
@sentry/browser (incl. sendFeedback) 34.94 kB - -
@sentry/browser (incl. FeedbackAsync) 40.05 kB - -
@sentry/browser (incl. Metrics) 30.9 kB - -
@sentry/browser (incl. Logs) 31.18 kB - -
@sentry/browser (incl. Metrics & Logs) 31.81 kB - -
@sentry/react 31.7 kB - -
@sentry/react (incl. Tracing) 54.39 kB - -
@sentry/vue 38.04 kB - -
@sentry/vue (incl. Tracing) 55.01 kB - -
@sentry/svelte 29.9 kB - -
@sentry/remix (Remix 3 client bundle) 57.08 kB - -
CDN Bundle 31.64 kB - -
CDN Bundle (incl. Tracing) 52.58 kB - -
CDN Bundle (incl. Logs, Metrics) 33.84 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) 54.52 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) 74.77 kB - -
CDN Bundle (incl. Tracing, Replay) 90.25 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) 92.18 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) 96.4 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) 98.34 kB - -
CDN Bundle - uncompressed 93.18 kB - -
CDN Bundle (incl. Tracing) - uncompressed 156.03 kB - -
CDN Bundle (incl. Logs, Metrics) - uncompressed 99.72 kB - -
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed 161.99 kB - -
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed 229.76 kB - -
CDN Bundle (incl. Tracing, Replay) - uncompressed 276.2 kB - -
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed 282.14 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed 289.9 kB - -
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed 295.84 kB - -
@sentry/nextjs (client) 56.8 kB - -
@sentry/sveltekit (client) 52.45 kB - -
@sentry/core/server 41.12 kB - -
@sentry/core/browser 13.81 kB - -
@sentry/node 153.16 kB +0.22% +322 B 🔺
@sentry/node/import (ESM hook with diagnostics-channel injection) 83.84 kB - -
@sentry/node - without tracing 94.95 kB +0.34% +313 B 🔺
@sentry/node - without channel injection 131.39 kB +0.25% +317 B 🔺
@sentry/aws-serverless 103.08 kB +0.28% +287 B 🔺
@sentry/cloudflare (withSentry) - minified 210.6 kB - -
@sentry/cloudflare (withSentry) 522.53 kB - -
@sentry/nextjs/cloudflare (withSentry) - minified 228.27 kB - -

View base workflow run

The hono devDependency of @sentry/hono (4.13.9) and the integration tests (^4.13.7)
resolved to two Hono copies. Their HonoRequest types differ by a unique symbol, so
sentry(app) did not type-check in the bun and cloudflare integration tests, and
yarn dedupe-deps:check failed. Resolve both to 4.13.9.

Refs #25223
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s1gr1d and others added 5 commits October 16, 2026 14:41
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Context hook and wrapSubAppMiddleware each had their own copy of the rule that tells
middleware from route handlers. Move the rule to getMiddlewareFlags() and check the shape
of the match result entries before the hook reads them. No behavior change.

Refs #25223
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Hono 5 removes c.req.matchedRoutes, so every request was named "GET ". It also restores
c.req.routeIndex after next(), so the Sentry middleware can no longer see which handler
responded. Read the match result through the getter that hono/route uses, and let each
route handler record its routeIndex when it starts. A request with no matched route keeps
the runtime's span name.

On Hono 4 the names stay the same, except where the old rule picked a later catch-all, for
example for a route handler declared with an unused next parameter.

Refs #25223
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Name the span when a route handler starts, so events captured in the handler get its route.
- Fall back to the first matched route handler, then to a middleware path. A request without a route keeps the runtime name.
- Wrap route handlers only when one of them declares `next`.
Base automatically changed from sig/hono-5--1-classifier to develop October 23, 2026 15:06
s1gr1d added a commit that referenced this pull request Oct 23, 2026
Preparation for #25454. No behavior change.

- The Context hook and `wrapSubAppMiddleware` had their own copies of
the rule that tells middleware from route handlers. Both now call
`getMiddlewareFlags()`
- The hook checks the shape of the match result entries once
(`isMatchedHandlerList()`), instead of optional chaining at each step

Ref #25223

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant