Skip to content

Route Server Actions directly to their owning routes - #96950

Open
ztanner wants to merge 2 commits into
canaryfrom
ztanner/action-dispatch-routing
Open

Route Server Actions directly to their owning routes#96950
ztanner wants to merge 2 commits into
canaryfrom
ztanner/action-dispatch-routing

Conversation

@ztanner

@ztanner ztanner commented Aug 7, 2026

Copy link
Copy Markdown
Member

Summary

Today, the client sends a Server Action request to the route it is currently rendering. If that route's worker does not contain the action, the server consults the action manifest and forwards the request to another worker that does.

This server-side forwarding introduces an extra internal request and requires the receiving worker to handle request state that belongs to the original route. It has caused correctness issues and miscellaneous bugs.

This change starts replacing that architecture by including opaque routing keys for the actions handled by each route in its Flight payload. The client records which route advertised each key. When an action is invoked, it hashes the action ID, looks up the corresponding route, and dispatches the request there directly.

When the destination differs from the currently rendered route, the client omits its router state tree. The server uses that absence to execute the action without attempting to render the destination page, while still returning the action result, redirect, and revalidation metadata.

The existing server-side forwarding mechanism remains in place temporarily and will be removed in a follow-up.

Verification

  • Added coverage confirming delayed actions and redirects are sent directly to their owning routes in Node.js and Edge runtimes.
  • Verified same-route action requests include router state and cross-route requests omit it.
  • Added unit coverage for missing action dispatch metadata.

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: 4dc31ce

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Stats from current PR

🔴 3 regressions, 2 improvements

Metric Canary PR Change Trend
node_modules Size 553 MB 554 MB 🔴 +542 kB (+0%) █████
Webpack Build Time 24.380s 25.219s 🔴 +839ms (+3%) ▄▃▄▁▄
Webpack Build Time (cached) 24.629s 25.507s 🔴 +878ms (+4%) ▅▂▄▁▅
Webpack Cold (First Request) 3.476s 3.331s 🟢 145ms (-4%) ▅█▁▁▃
Webpack Warm (First Request) 3.557s 3.342s 🟢 215ms (-6%) ▆▅▁▂▄
📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 864ms 862ms ▂▂▂▂▂
Cold (Ready in log) 829ms 822ms ▁▁▂▂▁
Cold (First Request) 1.398s 1.375s ▁▁▂▂▁
Warm (Listen) 819ms 864ms ▂▂▂▃▂
Warm (Ready in log) 817ms 830ms ▁▁▂▃▁
Warm (First Request) 1.362s 1.378s ▁▁▂▃▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 813ms 813ms █████
Cold (Ready in log) 805ms 781ms ▅█▄▃▅
Cold (First Request) 3.476s 3.331s 🟢 145ms (-4%) ▅█▁▁▃
Warm (Listen) 814ms 813ms █████
Warm (Ready in log) 812ms 787ms ▇▆▅▃▆
Warm (First Request) 3.557s 3.342s 🟢 215ms (-6%) ▆▅▁▂▄

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 6.335s 6.412s ▂▁▃▃▂
Cached Build 3.260s 3.404s ▁▁▄▃▂
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.380s 25.219s 🔴 +839ms (+3%) ▄▃▄▁▄
Cached Build 24.629s 25.507s 🔴 +878ms (+4%) ▅▂▄▁▅
node_modules Size 553 MB 554 MB 🔴 +542 kB (+0%) █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
0_z1ozsra2_86.js gzip 157 B N/A -
00r3fx3eeevxf.js gzip 158 B N/A -
050icza-xjz0i.js gzip 5.73 kB N/A -
07jdby0ue616s.js gzip 450 B N/A -
0anzicvq0iwy6.js gzip 46.7 kB N/A -
0bjdc8muo74n5.js gzip 8.71 kB N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB
0rci1f3or1a19.js gzip 13.3 kB N/A -
1_2x714--ii1i.js gzip 8.76 kB N/A -
1-3y752pkth5-.js gzip 10 kB N/A -
1-pbgw6jtibj4.js gzip 157 B N/A -
111w718tsk0_p.js gzip 71.5 kB N/A -
140m6hb0qpu8v.js gzip 157 B N/A -
160n3skrv1yk5.js gzip 157 B N/A -
1elt1qium-r2m.css gzip 115 B 115 B
1fsqx5xpdxd-c.js gzip 153 B N/A -
1hy0e5cihni_x.js gzip 7.54 kB N/A -
1tf1phijqlx9j.js gzip 220 B 220 B
1uq5fmtkqhu5v.js gzip 158 B N/A -
1uzabyd1120a1.js gzip 8.71 kB N/A -
2-ufv8lc-g7gg.js gzip 10.6 kB N/A -
21kmjy_10x14f.js gzip 8.81 kB N/A -
22alyybqz5_09.js gzip 3.57 kB N/A -
28dhc6t85q1_p.js gzip 8.78 kB N/A -
2ahs26ct36f9f.js gzip 65.6 kB N/A -
2btssrfgthink.js gzip 158 B N/A -
2f-ilvczue-tp.js gzip 9.46 kB N/A -
2f1u17u5c8iny.js gzip 8.79 kB N/A -
2ikltg_8iegxw.js gzip 10.3 kB N/A -
2vxi673cz1-t4.js gzip 8.79 kB N/A -
38-q43pzktqhs.js gzip 1.46 kB N/A -
3a-pgojsoq5_w.js gzip 158 B N/A -
3cruv3lb9957o.js gzip 169 B N/A -
3mrwxzed0ylgv.js gzip 13.1 kB N/A -
3nbojhxiy1qv_.js gzip 13.7 kB N/A -
3t5_y-uw--87g.js gzip 159 B N/A -
3wbfmg_ucf8de.js gzip 162 B N/A -
3xbq084zz-vz8.js gzip 163 B N/A -
41u5s3oe2-erp.js gzip 2.29 kB N/A -
445s_9hf8o7ao.js gzip 8.76 kB N/A -
turbopack-1l..-5yv.js gzip 3.73 kB 3.73 kB
0-6bcj16ji2wf.js gzip N/A 10.6 kB -
07ryk0jced-sc.js gzip N/A 8.78 kB -
0gr9avn-9b8xa.js gzip N/A 47.6 kB -
0j64ls9v56hnd.js gzip N/A 3.56 kB -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0lzqiphzyraxb.js gzip N/A 155 B -
0qma3l_t-wns4.js gzip N/A 168 B -
0roh390ijzxa5.js gzip N/A 8.75 kB -
0vex9w55ursqj.js gzip N/A 8.79 kB -
0ynj-axdw_was.js gzip N/A 155 B -
12uzup57ecfw9.js gzip N/A 160 B -
17oe55cu76cd7.js gzip N/A 450 B -
1822r4f_m9r_g.js gzip N/A 154 B -
19o-oimvx8r5g.js gzip N/A 71.6 kB -
1drww5xikb-c-.js gzip N/A 9.46 kB -
1g60xde_dv17t.js gzip N/A 8.79 kB -
1uzv47btzam64.js gzip N/A 5.73 kB -
1vy7n7wxv_rh5.js gzip N/A 8.81 kB -
2-0i7pl900-ou.js gzip N/A 8.71 kB -
2-kcbngm7ik7y.js gzip N/A 8.75 kB -
252pm4-yjo-g8.js gzip N/A 157 B -
28w0eio9rc6cp.js gzip N/A 156 B -
29p5-xa4jmdhg.js gzip N/A 13.7 kB -
2lpk5_hknut8q.js gzip N/A 13.1 kB -
2ugc69z0t0ypz.js gzip N/A 1.46 kB -
32pajiszar8p9.js gzip N/A 155 B -
3301-f5avh3en.js gzip N/A 157 B -
345geq-0tw2nd.js gzip N/A 156 B -
36a4lu088knjc.js gzip N/A 151 B -
36dn8i-_3dnq5.js gzip N/A 10 kB -
3dtb8zg2hpy5x.js gzip N/A 156 B -
3fljpmwcjxqhx.js gzip N/A 10.3 kB -
3gz44skqdlsrb.js gzip N/A 8.71 kB -
3m29pi-s05gfl.js gzip N/A 65.6 kB -
3oslhuq9luvp2.js gzip N/A 7.55 kB -
3s04zj-jqprop.js gzip N/A 155 B -
3y9tus7kb5su0.js gzip N/A 13.3 kB -
Total 401 kB 402 kB ⚠️ +937 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 1.05 kB 1.06 kB
Total 1.05 kB 1.06 kB ⚠️ +2 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 881 B 876 B
Total 881 B 876 B ✅ -5 B
Build Cache
Canary PR Change
00000001.sst gzip 14.8 MB 17.7 MB 🔴 +2.81 MB (+19%)
00000002.sst gzip 12.7 MB 10.9 MB 🟢 1.79 MB (-14%)
00000003.sst gzip 11.5 MB 13.9 MB 🔴 +2.38 MB (+21%)
00000004.sst gzip 16 MB 12.8 MB 🟢 3.17 MB (-20%)
00000005.sst gzip 10.2 MB 2.82 MB 🟢 7.4 MB (-72%)
00000006.sst gzip 2.81 MB 10.2 MB 🔴 +7.44 MB (+265%)
00000007.sst gzip 59 B 59 B
00000008.meta gzip 89 B 89 B
00000009.meta gzip 298 kB 298 kB
00000010.meta gzip 298 kB 298 kB
00000011.meta gzip 298 kB 298 kB
00000012.sst gzip 51.7 kB 52.5 kB 🔴 +810 B (+2%)
00000013.sst gzip 1.78 MB 1.86 MB 🔴 +83.9 kB (+5%)
00000014.sst gzip 59 B 59 B
00000015.meta gzip 116 B 116 B
00000016.meta gzip 325 kB 327 kB 🔴 +2.08 kB (+1%)
00000017.meta gzip 403 kB 407 kB 🔴 +3.29 kB (+1%)
00000018.sst gzip 52.4 kB 53.3 kB 🔴 +913 B (+2%)
00000019.sst gzip 1.39 MB 1.4 MB 🔴 +7.75 kB (+1%)
00000020.sst gzip 59 B 59 B
00000021.meta gzip 116 B 116 B
00000022.meta gzip 325 kB 327 kB 🔴 +2.08 kB (+1%)
00000023.meta gzip 371 kB 373 kB 🔴 +2.16 kB (+1%)
00000024.sst gzip 52.4 kB 53.4 kB 🔴 +1.03 kB (+2%)
00000025.sst gzip 1.39 MB 1.4 MB 🔴 +7.91 kB (+1%)
00000026.sst gzip 59 B 59 B
00000027.meta gzip 116 B 116 B
00000028.meta gzip 325 kB 327 kB 🔴 +2.08 kB (+1%)
00000029.meta gzip 371 kB 373 kB 🔴 +2.15 kB (+1%)
00000030.sst gzip 51.8 kB 52.8 kB 🔴 +936 B (+2%)
00000031.sst gzip 1.39 MB 1.4 MB 🔴 +7.99 kB (+1%)
00000032.sst gzip 59 B 59 B
00000033.meta gzip 116 B 116 B
00000034.meta gzip 325 kB 327 kB 🔴 +2.08 kB (+1%)
00000035.meta gzip 371 kB 373 kB 🔴 +2.15 kB (+1%)
00000036.sst gzip 52.4 kB 53.2 kB 🔴 +855 B (+2%)
00000037.sst gzip 1.39 MB 1.4 MB 🔴 +7.99 kB (+1%)
00000038.sst gzip 59 B 59 B
00000039.meta gzip 116 B 116 B
00000040.meta gzip 325 kB 327 kB 🔴 +2.08 kB (+1%)
00000041.meta gzip 371 kB 373 kB 🔴 +2.15 kB (+1%)
CURRENT gzip 24 B 24 B
LOG gzip 664 B 684 B 🔴 +20 B (+3%)
Total 80.1 MB 80.5 MB ⚠️ +402 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 65.7 kB N/A -
4191.HASH.js gzip 169 B N/A -
7920-HASH.js gzip 4.67 kB N/A -
9784-HASH.js gzip 5.63 kB N/A -
b1ad9f4c-HASH.js gzip 63.2 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 253 B 256 B 🔴 +3 B (+1%)
main-HASH.js gzip 40.1 kB 40.1 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
3577.HASH.js gzip N/A 168 B -
578-HASH.js gzip N/A 67.3 kB -
8590-HASH.js gzip N/A 5.61 kB -
9750-HASH.js gzip N/A 4.68 kB -
a8984546-HASH.js gzip N/A 63.2 kB -
Total 241 kB 243 kB ⚠️ +1.58 kB
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 194 B 193 B
_error-HASH.js gzip 181 B 182 B
css-HASH.js gzip 334 B 331 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 255 B 253 B
head-HASH.js gzip 349 B 351 B
hooks-HASH.js gzip 382 B 384 B
image-HASH.js gzip 581 B 582 B
index-HASH.js gzip 260 B 259 B
link-HASH.js gzip 2.48 kB 2.48 kB
routerDirect..HASH.js gzip 317 B 318 B
script-HASH.js gzip 384 B 386 B
withRouter-HASH.js gzip 316 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.95 kB 7.96 kB ⚠️ +4 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 129 kB 128 kB
page.js gzip 294 kB 296 kB
Total 423 kB 425 kB ⚠️ +1.79 kB
Middleware
Canary PR Change
middleware-b..fest.js gzip 617 B 617 B
middleware-r..fest.js gzip 156 B 156 B
middleware.js gzip 45.7 kB 45.2 kB 🟢 479 B (-1%)
edge-runtime..pack.js gzip 842 B 842 B
Total 47.3 kB 46.8 kB ✅ -479 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 717 B 718 B
Total 717 B 718 B ⚠️ +1 B
Build Cache
Canary PR Change
0.pack gzip 4.8 MB 4.82 MB 🔴 +22.3 kB (+0%)
index.pack gzip 124 kB 126 kB 🔴 +2 kB (+2%)
index.pack.old gzip 123 kB 124 kB 🔴 +1.27 kB (+1%)
Total 5.05 MB 5.07 MB ⚠️ +25.6 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 375 kB 376 kB
app-page-exp..prod.js gzip 207 kB 208 kB
app-page-tur...dev.js gzip 374 kB 376 kB
app-page-tur..prod.js gzip 207 kB 208 kB
app-page-tur...dev.js gzip 371 kB 372 kB
app-page-tur..prod.js gzip 205 kB 206 kB
app-page.run...dev.js gzip 371 kB 372 kB
app-page.run..prod.js gzip 205 kB 206 kB
app-route-ex...dev.js gzip 83.3 kB 83.5 kB
app-route-ex..prod.js gzip 56.4 kB 56.6 kB
app-route-tu...dev.js gzip 83.3 kB 83.5 kB
app-route-tu..prod.js gzip 56.4 kB 56.6 kB
app-route-tu...dev.js gzip 82.9 kB 83.1 kB
app-route-tu..prod.js gzip 56.2 kB 56.4 kB
app-route.ru...dev.js gzip 82.8 kB 83.1 kB
app-route.ru..prod.js gzip 56.2 kB 56.4 kB
dev-validati...dev.js gzip 133 kB 134 kB
dev-validati...dev.js gzip 133 kB 134 kB
dev-validati...dev.js gzip 131 kB 132 kB
dev-validati...dev.js gzip 131 kB 132 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 46 kB 46 kB
pages-api-tu..prod.js gzip 34.3 kB 34.3 kB
pages-api.ru...dev.js gzip 46 kB 46 kB
pages-api.ru..prod.js gzip 34.3 kB 34.3 kB
pages-turbo....dev.js gzip 54.8 kB 54.8 kB
pages-turbo...prod.js gzip 39.9 kB 39.9 kB
pages.runtim...dev.js gzip 54.8 kB 54.8 kB
pages.runtim..prod.js gzip 39.9 kB 39.9 kB
server.runti..prod.js gzip 67 kB 67.2 kB
use-cache-pr...dev.js gzip 72.3 kB 72.6 kB
use-cache-pr...dev.js gzip 72.4 kB 72.6 kB
use-cache-pr...dev.js gzip 70.6 kB 70.8 kB
use-cache-pr...dev.js gzip 70.6 kB 70.8 kB
Total 4.1 MB 4.12 MB ⚠️ +15.1 kB
📝 Changed Files (27 files)

Files with changes:

  • app-page-exp..ntime.dev.js
  • app-page-exp..time.prod.js
  • app-page-tur..ntime.dev.js
  • app-page-tur..time.prod.js
  • app-page-tur..ntime.dev.js
  • app-page-tur..time.prod.js
  • app-page.runtime.dev.js
  • app-page.runtime.prod.js
  • app-route-ex..ntime.dev.js
  • app-route-ex..time.prod.js
  • app-route-tu..ntime.dev.js
  • app-route-tu..time.prod.js
  • app-route-tu..ntime.dev.js
  • app-route-tu..time.prod.js
  • app-route.runtime.dev.js
  • app-route.ru..time.prod.js
  • dev-validati..ntime.dev.js
  • dev-validati..ntime.dev.js
  • dev-validati..ntime.dev.js
  • dev-validati..ntime.dev.js
  • ... and 7 more
View diffs
app-page-exp..ntime.dev.js
failed to diff
app-page-exp..time.prod.js
failed to diff
app-page-tur..ntime.dev.js
failed to diff
app-page-tur..time.prod.js
failed to diff
app-page-tur..ntime.dev.js
failed to diff
app-page-tur..time.prod.js
failed to diff
app-page.runtime.dev.js
failed to diff
app-page.runtime.prod.js
failed to diff
app-route-ex..ntime.dev.js

Diff too large to display

app-route-ex..time.prod.js

Diff too large to display

app-route-tu..ntime.dev.js

Diff too large to display

app-route-tu..time.prod.js

Diff too large to display

app-route-tu..ntime.dev.js

Diff too large to display

app-route-tu..time.prod.js

Diff too large to display

app-route.runtime.dev.js

Diff too large to display

app-route.ru..time.prod.js

Diff too large to display

dev-validati..ntime.dev.js

Diff too large to display

dev-validati..ntime.dev.js

Diff too large to display

dev-validati..ntime.dev.js

Diff too large to display

dev-validati..ntime.dev.js

Diff too large to display

pages-api.runtime.dev.js

Diff too large to display

pages.runtime.dev.js

Diff too large to display

server.runtime.prod.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/4dc31ce8a0a4ead928bb9c17c95e8278a3423a0c/next

Commit: 4dc31ce

Comment thread packages/next/src/shared/lib/server-action-routing-key.ts Outdated
@ztanner
ztanner force-pushed the ztanner/action-dispatch-routing branch from 9daf15f to 03805d0 Compare August 8, 2026 00:22
@ztanner
ztanner marked this pull request as ready for review August 8, 2026 00:46
@ztanner
ztanner force-pushed the ztanner/action-dispatch-routing branch from 03805d0 to 4dc31ce Compare August 8, 2026 00:49
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