{"record":{"id":"90fba7c433c12c95","repo":"juicedata/juicefs","slug":"failed-to-start-juicefs-service-by-net-use-s","errorCode":null,"errorMessage":"Failed to start juicefs service by 'net use': %s, output: %s","messagePattern":"Failed to start juicefs service by 'net use': (.+?), output: (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/winfsp/winfs.go","lineNumber":1479,"sourceCode":"\t\t// or the Explorer will not be able to disconnect the volume.\n\t\tcmd := exec.Command(winfspLauncher, \"start\", winfspServiceName, alias, alias, mountpoint)\n\t\tcmd.Dir = winFspBinPath\n\t\tlogger.Debugf(\"Mounting command(using launchctl): %s\", cmd.String())\n\n\t\tout, err := cmd.CombinedOutput()\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"Failed to mount juicefs as system service: %s, output: %s\", err, string(out))\n\t\t}\n\n\t\tif !checkIfMountProcessReady(mountpoint, 25) {\n\t\t\treturn fmt.Errorf(\"Mount command succeeded, but the mountpoint %s did not become ready in %d seconds, please check the juicefs logs for more information.\", mountpoint, 25)\n\t\t}\n\t} else {\n\t\tlogger.Debugf(\"Trying to start juicefs service by 'net use' command.\")\n\t\tcmd := exec.Command(\"net\", \"use\", mountpoint, fmt.Sprintf(\"\\\\\\\\%s\\\\%s\", winfspServiceName, alias), \"/Y\")\n\t\tout, err := cmd.CombinedOutput()\n\t\tif err != nil {\n\t\t\treturn fmt.Errorf(\"Failed to start juicefs service by 'net use': %s, output: %s\", err, string(out))\n\t\t}\n\t}\n\n\tlogger.Info(\"Juicefs mount process started successfully.\")\n\n\treturn nil\n}\n","sourceCodeStart":1461,"sourceCodeEnd":1487,"githubUrl":"https://github.com/juicedata/juicefs/blob/c9a67b23e8e08ec23ec331aa6f1675e2319e921c/pkg/winfsp/winfs.go#L1461-L1487","documentation":"Returned by the Windows mount path when starting the JuiceFS service via the winfsp launcher ('net use' style start) fails. It wraps the launcher's exit error and its combined output so the user can see why the service did not come up.","triggerScenarios":"Thrown at pkg/winfsp/winfs.go:1479 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check that WinFsp is installed and the winfsp launcher path is correct","Review the captured command output for service startup errors and retry the mount"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"c9a67b23e8e08ec23ec331aa6f1675e2319e921c","analyzedAt":"2026-09-06T17:55:48.476Z","contentChangedAt":"2026-09-06T17:55:48.476Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}