t8y2/dbx · error

decode ZooKeeper session password: %w

Error message

decode ZooKeeper session password: %w

What it means

Returned by newProtocolZooKeeperClient when the session password bytes of the connect response cannot be decoded — the buffer ends before the length-prefixed password field. Same class of failure as the other decode guards: a truncated/malformed handshake frame.

Source

Thrown at agents/drivers/hive-go/zookeeper_protocol.go:174

		return nil, fmt.Errorf("send ZooKeeper connect request: %w", err)
	}
	response, err := client.readFrame()
	if err != nil {
		return nil, fmt.Errorf("read ZooKeeper connect response: %w", err)
	}
	decoder := newZooKeeperDecoder(response)
	if _, err := decoder.int32(); err != nil {
		return nil, fmt.Errorf("decode ZooKeeper protocol version: %w", err)
	}
	if _, err := decoder.int32(); err != nil {
		return nil, fmt.Errorf("decode ZooKeeper session timeout: %w", err)
	}
	sessionID, err := decoder.int64()
	if err != nil {
		return nil, fmt.Errorf("decode ZooKeeper session ID: %w", err)
	}
	if _, err := decoder.bytes(); err != nil {
		return nil, fmt.Errorf("decode ZooKeeper session password: %w", err)
	}
	if sessionID == 0 {
		return nil, zk.ErrSessionExpired
	}
	return client, nil
}

func zooKeeperTimeoutMillis(timeout time.Duration) int32 {
	milliseconds := timeout.Milliseconds()
	if milliseconds < 1 {
		return 1
	}
	if milliseconds > math.MaxInt32 {
		return math.MaxInt32
	}
	return int32(milliseconds)
}

View on GitHub (pinned to c0390bff16)

Solutions

1. Rule out byte-stream corruption (TLS mismatch, proxies, packet truncation)
2. Validate the endpoint with an official ZooKeeper client
3. Fail over to another ZooKeeper server address

When it happens

Trigger: Thrown at agents/drivers/hive-go/zookeeper_protocol.go:174 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of t8y2/dbx@c0390bff16 (2026-09-05). Data as JSON: /api/errors/8c193c5438211805. Report an issue: GitHub.