juicedata/juicefs · error

connect to addr %s: %s

Error message

connect to addr %s: %s

What it means

Returned by newKVMeta when creating the underlying KV client fails; it wraps the driver-specific connection error (bad address, unreachable cluster, TLS problems) so the caller sees which address failed to connect.

Source

Thrown at pkg/meta/tkv.go:118

}

var _ Meta = (*kvMeta)(nil)
var _ engine = (*kvMeta)(nil)

var drivers = make(map[string]func(string) (tkvClient, error))

func newTkvClient(driver, addr string) (tkvClient, error) {
	fn, ok := drivers[driver]
	if !ok {
		return nil, fmt.Errorf("unsupported driver %s", driver)
	}
	return fn(addr)
}

func newKVMeta(driver, addr string, conf *Config) (Meta, error) {
	client, err := newTkvClient(driver, addr)
	if err != nil {
		return nil, fmt.Errorf("connect to addr %s: %s", addr, err)
	}
	// TODO: ping server and check latency > Millisecond
	// logger.Warnf("The latency to database is too high: %s", time.Since(start))
	m := &kvMeta{
		baseMeta: newBaseMeta(addr, conf),
		client:   client,
	}
	m.en = m
	return m, nil
}

func (m *kvMeta) Shutdown() error {
	m.of.close()
	return m.client.close()
}

func (m *kvMeta) Name() string {
	return m.client.name()

View on GitHub (pinned to c9a67b23e8)

Solutions

  1. Verify the KV cluster endpoints are reachable and credentials are correct
  2. Check TLS/CA configuration if the cluster uses encrypted connections
Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at pkg/meta/tkv.go:118 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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