Skip to content

Route Server Actions directly to their owning routes - #96950

Draft
ztanner wants to merge 4 commits into
canaryfrom
ztanner/action-dispatch-routing
Draft

Route Server Actions directly to their owning routes#96950
ztanner wants to merge 4 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. Each Flight response scopes its callServer callback to the URL and routing keys associated with that response. When an action is invoked, the client hashes its ID and dispatches it to that URL if the response's worker advertised the corresponding key. Otherwise, it checks whether another previously discovered route advertised the action.

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 coverage confirming references to the same action from different route contexts preserve their respective URLs, using a retained parallel route.

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: 316829b

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Stats from current PR

🔴 3 regressions

Metric Canary PR Change Trend
node_modules Size 553 MB 554 MB 🔴 +831 kB (+0%) █████
Webpack Build Time (cached) 24.345s 24.892s 🔴 +547ms (+2%) ▂▄▁▅▃
Webpack Cold (First Request) 3.331s 3.457s 🔴 +126ms (+4%) █▁▁▃▁
📊 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) 1.064s 1.063s ▂▂▂▂▁
Cold (Ready in log) 1.030s 1.040s ▁▂▂▁▁
Cold (First Request) 1.705s 1.700s ▁▂▂▁▁
Warm (Listen) 1.065s 1.065s ▂▂▃▂▁
Warm (Ready in log) 1.045s 1.040s ▁▂▃▁▁
Warm (First Request) 1.682s 1.694s ▁▂▃▁▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 812ms 813ms █████
Cold (Ready in log) 778ms 796ms █▄▃▅▃
Cold (First Request) 3.331s 3.457s 🔴 +126ms (+4%) █▁▁▃▁
Warm (Listen) 813ms 812ms █████
Warm (Ready in log) 780ms 778ms ▆▅▃▆▄
Warm (First Request) 3.319s 3.367s ▆▁▂▄▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 7.816s 7.949s ▁▄▃▂▁
Cached Build 3.970s 3.925s ▁▄▃▂▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.635s 24.595s ▃▄▁▄▂
Cached Build 24.345s 24.892s 🔴 +547ms (+2%) ▂▄▁▅▃
node_modules Size 553 MB 554 MB 🔴 +831 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 -
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 -
0ugobmoodimiq.js gzip N/A 48 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 -
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 -
3cfb6sczi3pmw.js gzip N/A 71.7 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 ⚠️ +1.48 kB

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 MB 12.4 MB 🟢 1.54 MB (-11%)
00000002.sst gzip 13.1 MB 13.3 MB 🔴 +245 kB (+2%)
00000003.sst gzip 15.9 MB 15.2 MB 🟢 700 kB (-4%)
00000004.sst gzip 12.1 MB 14.3 MB 🔴 +2.22 MB (+18%)
00000005.sst gzip 10.2 MB 10.2 MB 🔴 +59.3 kB (+1%)
00000006.sst gzip 2.81 MB 2.82 MB 🔴 +12.7 kB (+0%)
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.9 kB 52.3 kB
00000013.sst gzip 1.83 MB 1.87 MB 🔴 +40.1 kB (+2%)
00000014.sst gzip 59 B 59 B
00000015.meta gzip 116 B 116 B
00000016.meta gzip 325 kB 327 kB 🔴 +2.12 kB (+1%)
00000017.meta gzip 404 kB 408 kB 🔴 +3.19 kB (+1%)
00000018.sst gzip 52.6 kB 53.1 kB 🔴 +561 B (+1%)
00000019.sst gzip 1.39 MB 1.4 MB 🔴 +13.8 kB (+1%)
00000020.sst gzip 59 B 59 B
00000021.meta gzip 116 B 116 B
00000022.meta gzip 325 kB 327 kB 🔴 +2.12 kB (+1%)
00000023.meta gzip 371 kB 373 kB 🔴 +2.08 kB (+1%)
00000024.sst gzip 52.6 kB 53.1 kB
00000025.sst gzip 1.39 MB 1.4 MB 🔴 +13.9 kB (+1%)
00000026.sst gzip 59 B 59 B
00000027.meta gzip 116 B 116 B
00000028.meta gzip 325 kB 327 kB 🔴 +2.12 kB (+1%)
00000029.meta gzip 371 kB 373 kB 🔴 +2.09 kB (+1%)
00000030.sst gzip 52.1 kB 52.4 kB
00000031.sst gzip 1.39 MB 1.4 MB 🔴 +13.9 kB (+1%)
00000032.sst gzip 59 B 59 B
00000033.meta gzip 116 B 116 B
00000034.meta gzip 325 kB 327 kB 🔴 +2.12 kB (+1%)
00000035.meta gzip 371 kB 373 kB 🔴 +2.09 kB (+1%)
00000036.sst gzip 52.4 kB 53 kB 🔴 +610 B (+1%)
00000037.sst gzip 1.39 MB 1.4 MB 🔴 +13.9 kB (+1%)
00000038.sst gzip 59 B 59 B
00000039.meta gzip 116 B 116 B
00000040.meta gzip 325 kB 327 kB 🔴 +2.12 kB (+1%)
00000041.meta gzip 371 kB 373 kB 🔴 +2.09 kB (+1%)
CURRENT gzip 24 B 24 B
LOG gzip 677 B 671 B
Total 80.2 MB 80.6 MB ⚠️ +415 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.9 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 ⚠️ +2.18 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 297 kB 🔴 +2.59 kB (+1%)
Total 423 kB 425 kB ⚠️ +2.36 kB
Middleware
Canary PR Change
middleware-b..fest.js gzip 617 B 618 B
middleware-r..fest.js gzip 156 B 156 B
middleware.js gzip 45.7 kB 45.3 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 47.3 kB 46.9 kB ✅ -430 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.83 MB 🔴 +25.4 kB (+1%)
index.pack gzip 123 kB 125 kB 🔴 +2.15 kB (+2%)
index.pack.old gzip 122 kB 125 kB 🔴 +2.28 kB (+2%)
Total 5.05 MB 5.07 MB ⚠️ +29.8 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 375 kB 377 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 373 kB
app-page-tur..prod.js gzip 205 kB 206 kB
app-page.run...dev.js gzip 371 kB 373 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 ⚠️ +19.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-tu..ntime.dev.js

Diff too large to display

pages-turbo...ntime.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/316829b205658da65a1c5b5a910864a2b2294e92/next

Commit: 316829b

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
@ztanner
ztanner force-pushed the ztanner/action-dispatch-routing branch from 4dc31ce to 47306ef Compare August 8, 2026 14:52
@ztanner
ztanner marked this pull request as draft August 8, 2026 15:41
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