Turbopack: improve error message for incompatible swc plugins #86346

mischnic · 2025-11-20T10:24:22Z

Before:

Module not found: Can't resolve 'next/dist/esm/build/templates/helpers'
failed to analyze ecmascript module '[project]/node_modules/.pnpm/next@file+..+next-repo-2bf56e024dbccc85257a8c308492f2375d690b206153b02d3bea2029707d4c38+packa_tacnzof7rtmb5bwqa7bdnfcdbq/node_modules/next/dist/esm/build/templates/helpers.js [ssr] (ecmascript)'

Caused by:
- failed to parse [project]/node_modules/.pnpm/next@file+..+next-repo-2bf56e024dbccc85257a8c308492f2375d690b206153b02d3bea2029707d4c38+packa_tacnzof7rtmb5bwqa7bdnfcdbq/node_modules/next/dist/esm/build/templates/helpers.js
- Transforming and/or parsing of [project]/node_modules/.pnpm/next@file+..+next-repo-2bf56e024dbccc85257a8c308492f2375d690b206153b02d3bea2029707d4c38+packa_tacnzof7rtmb5bwqa7bdnfcdbq/node_modules/next/dist/esm/build/templates/helpers.js failed
- failed to deserialize `swc_common::plugin::diagnostics::PluginCorePkgDiagnostics`
- Mismatch { name: "array", found: 48 }

Debug info:
- Execution of <ModuleAssetContext as AssetContext>::process_resolve_result failed
- Execution of <ModuleAssetContext as AssetContext>::process failed
- Execution of <EcmascriptModuleAsset as Module>::side_effects failed
- Execution of analyze_ecmascript_module failed
- failed to analyze ecmascript module '[project]/node_modules/.pnpm/next@file+..+next-repo-2bf56e024dbccc85257a8c308492f2375d690b206153b02d3bea2029707d4c38+packa_tacnzof7rtmb5bwqa7bdnfcdbq/node_modules/next/dist/esm/build/templates/helpers.js [ssr] (ecmascript)'
- Execution of <EcmascriptModuleAsset as EcmascriptParsable>::failsafe_parse failed
- Execution of parse failed
- failed to parse [project]/node_modules/.pnpm/next@file+..+next-repo-2bf56e024dbccc85257a8c308492f2375d690b206153b02d3bea2029707d4c38+packa_tacnzof7rtmb5bwqa7bdnfcdbq/node_modules/next/dist/esm/build/templates/helpers.js
- Transforming and/or parsing of [project]/node_modules/.pnpm/next@file+..+next-repo-2bf56e024dbccc85257a8c308492f2375d690b206153b02d3bea2029707d4c38+packa_tacnzof7rtmb5bwqa7bdnfcdbq/node_modules/next/dist/esm/build/templates/helpers.js failed
- failed to deserialize `swc_common::plugin::diagnostics::PluginCorePkgDiagnostics`
- Mismatch { name: "array", found: 48 }
Import map: aliased to module 'next' with subpath '/dist/esm/build/templates/helpers' inside of [project]/


https://nextjs.org/docs/messages/module-not-found

After:

./packages/next/document.js
Failed to execute SWC plugin
An unexpected error occurred when executing an SWC EcmaScript transform plugin.
This might be due to a version mismatch between the plugin and Next.js.

Failed to execute @swc/plugin-react-remove-properties

Caused by:
    0: failed to deserialize `swc_common::plugin::diagnostics::PluginCorePkgDiagnostics`
    1: Mismatch { name: "array", found: 48 }

mischnic · 2025-11-20T10:24:37Z

Turbopack: improve error message for incompatible swc plugins #86346 👈 (View in Graphite)
canary

This stack of pull requests is managed by Graphite. Learn more about stacking.

nextjs-bot · 2026-01-08T09:38:01Z

Allow CI Workflow Run

approve CI run for commit: 224f11c

Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer

nextjs-bot · 2026-01-08T09:45:15Z

Tests Passed

codspeed-hq · 2026-01-08T09:57:48Z

CodSpeed Performance Report

Merging this PR will not alter performance

_{Comparing mischnic/swc-plugin-version-test (70b8754) with canary (a6f23d8)}

Summary

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks¹

3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

nextjs-bot · 2026-01-08T10:19:37Z

Stats from current PR

✅ No significant changes detected

📊 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)	455ms	455ms	✓	█▁▁▁▁
Cold (First Request)	1.140s	1.101s	✓	▄█▇▁█
Warm (Listen)	456ms	456ms	✓	█▁▁▁▁
Warm (First Request)	339ms	339ms	✓	▅▅▁▄▅

📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric	Canary	PR	Change	Trend
Cold (Listen)	455ms	455ms	✓	▅▁▁▁▅
Cold (First Request)	1.825s	1.820s	✓	▁▆▁▆▂
Warm (Listen)	456ms	455ms	✓	▁▁▅▅▅
Warm (First Request)	1.849s	1.837s	✓	▁▅▁▆▁

⚡ Production Builds

Metric	Canary	PR	Change	Trend
Fresh Build	4.045s	4.044s	✓	█▁▁▁▁
Cached Build	4.035s	4.017s	✓	█▁▁▂▁

📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric	Canary	PR	Change	Trend
Fresh Build	13.985s	13.970s	✓	▂▂▁▃▂
Cached Build	14.027s	14.068s	✓	▂▁▃▃▂
node_modules Size	457 MB	457 MB	✓	█████

📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **430 kB** → **430 kB** ✅ -4 B

82 files with content-based hashes (individual files not comparable between builds)

Server

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	793 B	796 B	✓
Total	793 B	796 B	⚠️ +3 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	449 B	450 B	✓
Total	449 B	450 B	⚠️ +1 B

📦 Webpack

Client

Main Bundles

	Canary	PR	Change
2086.HASH.js gzip	169 B	N/A	-
2161-HASH.js gzip	5.41 kB	N/A	-
2747-HASH.js gzip	4.48 kB	N/A	-
4322-HASH.js gzip	52.7 kB	N/A	-
ec793fe8-HASH.js gzip	62.3 kB	N/A	-
framework-HASH.js gzip	59.8 kB	59.8 kB	✓
main-app-HASH.js gzip	251 B	254 B	🔴 +3 B (+1%)
main-HASH.js gzip	38.6 kB	39 kB	✓
webpack-HASH.js gzip	1.68 kB	1.68 kB	✓
1596.HASH.js gzip	N/A	169 B	-
2658-HASH.js gzip	N/A	52.5 kB	-
6349-HASH.js gzip	N/A	4.46 kB	-
7019-HASH.js gzip	N/A	5.43 kB	-
b17a3386-HASH.js gzip	N/A	62.3 kB	-
Total	225 kB	225 kB	⚠️ +157 B

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	182 B	182 B	✓
css-HASH.js gzip	336 B	335 B	✓
dynamic-HASH.js gzip	1.8 kB	1.8 kB	✓
edge-ssr-HASH.js gzip	256 B	256 B	✓
head-HASH.js gzip	352 B	349 B	✓
hooks-HASH.js gzip	385 B	384 B	✓
image-HASH.js gzip	580 B	580 B	✓
index-HASH.js gzip	259 B	258 B	✓
link-HASH.js gzip	2.5 kB	2.51 kB	✓
routerDirect..HASH.js gzip	319 B	317 B	✓
script-HASH.js gzip	385 B	387 B	✓
withRouter-HASH.js gzip	316 B	315 B	✓
1afbb74e6ecf..834.css gzip	106 B	106 B	✓
Total	7.97 kB	7.96 kB	✅ -8 B

Server

Edge SSR

	Canary	PR	Change
edge-ssr.js gzip	125 kB	125 kB	✓
page.js gzip	239 kB	239 kB	✓
Total	364 kB	364 kB	⚠️ +274 B

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	653 B	654 B	✓
middleware-r..fest.js gzip	155 B	156 B	✓
middleware.js gzip	32.7 kB	33 kB	🔴 +342 B (+1%)
edge-runtime..pack.js gzip	842 B	842 B	✓
Total	34.3 kB	34.7 kB	⚠️ +344 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	738 B	738 B	✓
Total	738 B	738 B	✓

Build Cache

	Canary	PR	Change
0.pack gzip	3.61 MB	3.61 MB	✓
index.pack gzip	99 kB	98.5 kB	✓
index.pack.old gzip	98.5 kB	99.7 kB	🔴 +1.24 kB (+1%)
Total	3.81 MB	3.81 MB	⚠️ +2.91 kB

🔄 Shared (bundler-independent)

Runtimes

	Canary	PR	Change
app-page-exp...dev.js gzip	303 kB	303 kB	✓
app-page-exp..prod.js gzip	157 kB	157 kB	✓
app-page-tur...dev.js gzip	302 kB	302 kB	✓
app-page-tur..prod.js gzip	157 kB	157 kB	✓
app-page-tur...dev.js gzip	299 kB	299 kB	✓
app-page-tur..prod.js gzip	155 kB	155 kB	✓
app-page.run...dev.js gzip	299 kB	299 kB	✓
app-page.run..prod.js gzip	155 kB	155 kB	✓
app-route-ex...dev.js gzip	68.2 kB	68.2 kB	✓
app-route-ex..prod.js gzip	46.9 kB	46.9 kB	✓
app-route-tu...dev.js gzip	68.2 kB	68.2 kB	✓
app-route-tu..prod.js gzip	46.9 kB	46.9 kB	✓
app-route-tu...dev.js gzip	67.8 kB	67.8 kB	✓
app-route-tu..prod.js gzip	46.7 kB	46.7 kB	✓
app-route.ru...dev.js gzip	67.8 kB	67.8 kB	✓
app-route.ru..prod.js gzip	46.7 kB	46.7 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	41.1 kB	41.1 kB	✓
pages-api-tu..prod.js gzip	31.2 kB	31.2 kB	✓
pages-api.ru...dev.js gzip	41.1 kB	41.1 kB	✓
pages-api.ru..prod.js gzip	31.2 kB	31.2 kB	✓
pages-turbo....dev.js gzip	50.8 kB	50.8 kB	✓
pages-turbo...prod.js gzip	38.2 kB	38.2 kB	✓
pages.runtim...dev.js gzip	50.8 kB	50.8 kB	✓
pages.runtim..prod.js gzip	38.2 kB	38.2 kB	✓
server.runti..prod.js gzip	62 kB	62 kB	✓
Total	2.67 MB	2.67 MB	⚠️ +3 B

bgw

Much nicer! Thank you!

bgw · 2026-01-08T21:32:49Z

turbopack/crates/turbopack-ecmascript-plugins/src/transform/swc_ecma_transform_plugins.rs

+    fn description(&self) -> Vc<OptionStyledString> {
+        Vc::cell(Some(
+            StyledString::Stack(vec![
+                StyledString::Text(rcstr!(
+                    "An unexpected error occurred when executing an SWC EcmaScript transform \
+                     plugin."
+                )),
+                StyledString::Text(rcstr!(
+                    "This might be due to a version mismatch between the plugin and Next.js."
+                )),
+                StyledString::Text(Default::default()),
+                self.description.clone(),
+            ])
+            .resolved_cell(),
+        ))
+    }


We could link to https://plugins.swc.rs/

I don't know this this should be part of description or documentation_link though.

It looked a bit weird with documentation_link, so I put into the description

turbopack/crates/turbopack-ecmascript-plugins/src/transform/swc_ecma_transform_plugins.rs

mischnic · 2026-01-09T19:57:42Z

Merge activity

Jan 9, 7:57 PM UTC: @mischnic merged this pull request with Graphite.

mischnic changed the title ~~Better tests for incompatible swc plugins~~ Turbopack: improve error message for incompatible swc plugins Jan 8, 2026

mischnic force-pushed the mischnic/swc-plugin-version-test branch from cd34493 to 224f11c Compare January 8, 2026 09:32

nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. tests Turbopack Related to Turbopack with Next.js. labels Jan 8, 2026

mischnic requested a review from a team January 8, 2026 09:32

mischnic marked this pull request as ready for review January 8, 2026 09:43

mischnic force-pushed the mischnic/swc-plugin-version-test branch from 224f11c to 8d6457d Compare January 8, 2026 09:45

mischnic force-pushed the mischnic/swc-plugin-version-test branch from 8d6457d to e0a3c51 Compare January 8, 2026 09:57

mischnic force-pushed the mischnic/swc-plugin-version-test branch from e0a3c51 to 768515a Compare January 8, 2026 11:53

bgw approved these changes Jan 8, 2026

View reviewed changes

mischnic added 6 commits January 9, 2026 10:05

Better tests for incompatible swc plugins

4d3fa17

update message

6bd8271

proper error

d26e9c4

revert

6124fd5

cleanup

ddfd978

link to plugins.swc.rs

70b8754

mischnic force-pushed the mischnic/swc-plugin-version-test branch from 768515a to 70b8754 Compare January 9, 2026 09:44

mischnic merged commit 77c69a7 into canary Jan 9, 2026
295 of 297 checks passed

mischnic deleted the mischnic/swc-plugin-version-test branch January 9, 2026 19:57

Turbopack: improve error message for incompatible swc plugins #86346

Turbopack: improve error message for incompatible swc plugins #86346

Conversation

mischnic commented Nov 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mischnic commented Nov 20, 2025

Uh oh!

nextjs-bot commented Jan 8, 2026

Uh oh!

nextjs-bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Tests Passed

Uh oh!

codspeed-hq bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CodSpeed Performance Report

Merging this PR will not alter performance

Summary

Footnotes

Uh oh!

nextjs-bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Stats from current PR

✅ No significant changes detected

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

bgw left a comment

Choose a reason for hiding this comment

Uh oh!

bgw Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

mischnic Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

mischnic commented Jan 9, 2026

Merge activity

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

mischnic commented Nov 20, 2025 •

edited

Loading

nextjs-bot commented Jan 8, 2026 •

edited

Loading

codspeed-hq bot commented Jan 8, 2026 •

edited

Loading

nextjs-bot commented Jan 8, 2026 •

edited

Loading

mischnic Jan 9, 2026 •

edited

Loading