fuseNewConnect(usrname=%s): Unable to create fs: error code

Error message

fuseNewConnect(usrname=%s): Unable to create fs: error code %d

What it means

Error "fuseNewConnect(usrname=%s): Unable to create fs: error code %d " thrown in apache/hadoop.

Source

Thrown at hadoop-hdfs-project/hadoop-hdfs-native-client/src/main/native/fuse-dfs/fuse_connect.c:519

    // with ticket cache based authentication as we have the OS user name here
    // not the real kerberos principal name. So with SIMPLE auth we pass on the
    // OS username still, and the UGI will use that as the username, but with
    // kerberos authentication we do not pass in the OS username and let the
    // authentication happen with the principal who's ticket is in the ticket
    // cache. (HDFS-15034 is still a possible improvement for SIMPLE AUTH.)
    hdfsBuilderSetUserName(bld, usrname);
  }
  conn->usrname = strdup(usrname);
  if (!conn->usrname) {
    fprintf(stderr, "fuseNewConnect: OOM allocating usrname\n");
    ret = -ENOMEM;
    goto error;
  }
  conn->fs = hdfsBuilderConnect(bld);
  bld = NULL;
  if (!conn->fs) {
    ret = errno;
    fprintf(stderr, "fuseNewConnect(usrname=%s): Unable to create fs: "
            "error code %d\n", usrname, ret);
    goto error;
  }
  RB_INSERT(hdfsConnTree, &gConnTree, conn);
  *out = conn;
  return 0;

error:
  if (bld) {
    hdfsFreeBuilder(bld);
  }
  if (conn) {
    free(conn->kpath);
    free(conn->usrname);
    free(conn);
  }
  return ret;
}

View on GitHub (pinned to 2add963021)

Solutions

Check the libhdfs/JVM error code; verify HADOOP_CONF_DIR and CLASSPATH are set correctly so libhdfs can build the FileSystem object.
Ensure the NameNode URI and Kerberos configuration are valid, then retry the mount.

When it happens

Trigger: Thrown at hadoop-hdfs-project/hadoop-hdfs-native-client/src/main/native/fuse-dfs/fuse_connect.c:519 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/hadoop@2add963021 (2026-08-22). Data as JSON: /api/errors/81cce65dbe21371f. Report an issue: GitHub.