{"record":{"id":"95c449a5d8922daf","repo":"jdx/mise","slug":"message-locked-mode-requires-the-locked-precompi","errorCode":null,"errorMessage":"{message}\nlocked mode requires the locked precompiled artifact","messagePattern":"(.+?)\nlocked mode requires the locked precompiled artifact","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"src/plugins/core/node.rs","lineNumber":136,"sourceCode":"                    ExtractionFormat::TarGz,\n                    &ExtractOptions {\n                        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    }","sourceCodeStart":118,"sourceCodeEnd":154,"githubUrl":"https://github.com/jdx/mise/blob/533346cc374382b41ec5ff70536252b2e96e725c/src/plugins/core/node.rs#L118-L154","documentation":"When node precompiled archive fetch returns NotFound in locked mode and a flavor-specific message exists (e.g. for node flavors whose builds are not published), the error is raised with the flavor message plus the locked-mode requirement, explaining that locked installs cannot fall back to compiling or other artifacts.","triggerScenarios":"Running `mise install node` (or exec/use) with locked mode active, node_compile disabled by lock semantics, and the requested node flavor's precompiled archive not being found upstream.","commonSituations":"Using locked mode (mise.lock) with a node flavor whose official precompiled builds don't exist for the platform/version; stale lock pointing at a removed artifact.","solutions":["Regenerate mise.lock with `mise lock` so it points at an existing artifact","Remove the flavor requirement (use standard node) or switch to a version with published flavor builds","Disable locked mode if you can accept a source compile fallback"],"exampleFix":"# before\nmise install node@20.0.0  # locked, flavor build missing\n\n# after\nmise lock && mise install node@20.0.0\n# or drop the flavor: mise use node@20.0.0","handlingStrategy":"fallback","validationCode":"# verify the flavor archive exists for the platform before locked install\ncurl -sfIL \"https://nodejs.org/dist/v20.0.0/node-v20.0.0-linux-x64.tar.gz\"","typeGuard":null,"tryCatchPattern":"mise install node@X || { mise lock; mise install node@X; }","preventionTips":["Verify flavored node builds exist for your OS/arch before locking","Prefer official node builds unless a flavor is required","Keep mise.lock fresh with periodic `mise lock`"],"tags":["node","locked-mode","precompiled","flavor"],"backgroundTag":"resource-not-found","analyzedSha":"533346cc374382b41ec5ff70536252b2e96e725c","analyzedAt":"2026-09-17T13:35:38.149Z","contentChangedAt":"2026-09-17T13:35:38.149Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}