What causes "failed to find mount process" in juicedata/juicefs?

Verify the mount is running: check `tasklist | findstr juicefs` or the drive in Explorer; mount first if not mounted

failed to find mount process

Error message

failed to find mount process

What it means

After running the wmic process query, findMountProcess splits the output on \r\n and expects a header line plus at least one data line. If the output has fewer than 2 lines, no process with the juicefs executable name was found, so no mount process exists for the given mountpoint.

Source

Thrown at cmd/debug_windows.go:68

			continue
		}
		return sline, nil
	}

	return "", fmt.Errorf("cannot find command line for pid %d. If the juicefs are mounted at background, Please rerun this with the admin permission.", pid)
}

func findMountProcess(mp string) (int, error) {
	processName := filepath.Base(os.Args[0])
	cmd := exec.Command("wmic", "process", "where", fmt.Sprintf("name='%s'", processName), "get", "CommandLine,ProcessId")
	out, err := cmd.CombinedOutput()
	if err != nil {
		return 0, fmt.Errorf("failed to exec command line: %s, %s", cmd.String(), err)
	}

	lines := strings.Split(string(out), "\r\n")
	if len(lines) < 2 {
		return 0, fmt.Errorf("failed to find mount process")
	}

	mp = strings.TrimRight(mp, "\\")
	for _, line := range lines[1:] {
		sline := strings.TrimSpace(line)

		if sline == "" {
			continue
		}

		// the first part of commandline contains 'xxx/mount.exe"'
		slines := strings.SplitN(sline, ".exe\" ", 2)
		if len(slines) < 2 {
			logger.Warnf("failed to split command line: %s", sline)
			continue
		}

		sline = slines[1]

View on GitHub (pinned to c9a67b23e8)

Solutions

Verify the mount is running: check `tasklist | findstr juicefs` or the drive in Explorer; mount first if not mounted
Run `juicefs debug` from an elevated prompt so wmic can list processes from other sessions
Ensure the debug command uses the same binary name as the running mount process (findMountProcess matches filepath.Base(os.Args[0]))
If the mount runs under another user, restart debug in that user's context or as admin

Defensive patterns

Strategy: validation

Validate before calling

// ensure a mount process for this binary exists before debugging
out, _ := exec.Command("tasklist", "/FI", fmt.Sprintf("IMAGENAME eq %s", filepath.Base(os.Args[0]))).CombinedOutput()
if !strings.Contains(strings.ToLower(string(out)), strings.ToLower(filepath.Base(os.Args[0]))) {
	return fmt.Errorf("no running %s process; is the volume mounted?", filepath.Base(os.Args[0]))
}

Try / catch

_, pid, _, err := getCmdMount(mp)
if err != nil {
	if strings.Contains(err.Error(), "failed to find mount process") {
		// volume not mounted or mount died: instruct user to mount first
	}
	return err
}

Prevention

Run `juicefs debug` only on a mountpoint that is currently mounted
Use the same binary (same name) for debug as the one used to mount — the search matches filepath.Base(os.Args[0])
Run elevated so wmic can enumerate processes of all sessions/users
Confirm the drive appears mounted in Explorer/tasklist before debugging

When it happens

Trigger: `juicefs debug <mountpoint>` falls back to findMountProcess (no pid in config); wmic returns only a header (or empty) because no process named like os.Args[0] (juicefs.exe) is currently running, meaning the volume is not mounted or the mount process has died.

Common situations: Running `juicefs debug` on a mountpoint that was never mounted or whose mount already exited; running debug with a differently-named binary (renamed juicefs.exe) than the one used to mount; wmic silently returning nothing due to permission limits.

Understand the failure class

Background: 'Could not be found', 'does not exist', 'not found in database': the resource-not-found family when an ID, slug, key, or URI lookup comes back empty — this error's family across 20 libraries.

Related errors

AI-assisted analysis of juicedata/juicefs@c9a67b23e8 (2026-09-06). Data as JSON: /api/errors/2b91ffd0575e0ed7. Report an issue: GitHub.