{"record":{"id":"28bf2ac578b1947a","repo":"jdx/mise","slug":"precompiled-node-archive-not-found-and-locked-mode","errorCode":null,"errorMessage":"precompiled node archive not found and locked mode requires the locked precompiled artifact","messagePattern":"precompiled node archive not found and locked mode requires the locked precompiled artifact","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/plugins/core/node.rs","lineNumber":138,"sourceCode":"                        strip_components: 1,\n                        pr: Some(ctx.pr.as_ref()),\n                        ..Default::default()\n                    },\n                )?;\n                Ok(())\n            })\n            .await?\n        {\n            FetchOutcome::Downloaded => {\n                warn_patches_not_applied();\n                Ok(())\n            }\n            FetchOutcome::NotFound => {\n                if ctx.locked {\n                    if let Some(message) = node_flavor_not_found_message(opts) {\n                        bail!(\"{message}\\nlocked mode requires the locked precompiled artifact\")\n                    }\n                    bail!(\n                        \"precompiled node archive not found and locked mode requires the locked precompiled artifact\"\n                    )\n                } else if Settings::get().node_compile(CompilePurpose::Inspect) != Some(false) {\n                    if let Some(message) = node_flavor_not_found_message(opts) {\n                        warn!(\"{message}\");\n                    }\n                    self.install_compiling(ctx, tv, opts).await\n                } else {\n                    if let Some(message) = node_flavor_not_found_message(opts) {\n                        bail!(\"{message}\\ncompilation is disabled\")\n                    }\n                    bail!(\"precompiled node archive not found and compilation is disabled\")\n                }\n            }\n        }\n    }\n\n    async fn install_windows(","sourceCodeStart":120,"sourceCodeEnd":156,"githubUrl":"https://github.com/jdx/mise/blob/afd2eddd3a50c16190efc1c7e94404b48f72af57/src/plugins/core/node.rs#L120-L156","documentation":"Same locked-mode Node path as the flavor variant, but this fires when no flavor-specific message applies: the precompiled Node archive was not found and locked mode forbids any fallback (such as compiling from source), so mise aborts with the generic message. Thrown in install_precompiled on FetchOutcome::NotFound when ctx.locked is true.","triggerScenarios":"Locked `mise install node` where the locked version has no downloadable precompiled archive for the current platform (asset missing upstream, unsupported platform/arch, or upstream 404) and node_compile fallback doesn't apply.","commonSituations":"Very new Node release not yet built upstream; platform without published binaries; misconfigured lock entry pointing at a version whose assets were removed; CI environments with locked installs hitting missing artifacts.","solutions":["Re-run `mise lock` to refresh the locked artifact URL/checksum once upstream publishes it","Switch to a Node version with published precompiled assets for your platform","Unlock (regenerate mise.lock without locked constraints) to permit source-compilation fallback","Verify the platform/arch is one Node publishes binaries for (linux/mac/windows, x64/arm64)"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":"# confirm the platform has precompiled node binaries before locked install\nmise settings get node_compile  # ensure a source fallback is permitted if needed","typeGuard":null,"tryCatchPattern":"catch (e) {\n  if (String(e).includes(\"precompiled node archive not found and locked mode\")) {\n    // run `mise lock` to refresh, or unlock to allow compiling\n  }\n}","preventionTips":["Re-lock before installing brand-new Node versions","Only lock on platforms with published Node binaries","Keep node_compile enabled unless locked installs are verified to work"],"tags":["node","locked-mode","precompiled","artifact"],"backgroundTag":"artifact-not-found","analyzedSha":"afd2eddd3a50c16190efc1c7e94404b48f72af57","analyzedAt":"2026-09-09T01:38:25.179Z","contentChangedAt":"2026-09-09T01:38:25.179Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}