lionsoul2014/ip2region · error

NewV6Config: %w

Error message

NewV6Config: %w

What it means

Go service factory: NewV6Config (open/verify/header/version/cache loading for the v6 xdb) failed; the wrapped cause identifies the failing step, e.g. bad file or version mismatch.

Source

Thrown at binding/golang/main.go:69

	}
	v4Config, err := service.NewV4Config(v4CPolicy, v4DbPath, 1)
	if err != nil {
		return nil, fmt.Errorf("NewV4Config: %w", err)
	}

	// try to create v6 config
	v6Policy, err := service.CachePolicyFromName(v6CachePolicy)
	if err != nil {
		return nil, fmt.Errorf("parse v6 cache policy: %w", err)
	}

	v6DbPath, err := homedir.Expand(v6XdbPath)
	if err != nil {
		return nil, fmt.Errorf("Expand(`%s`): %s", v6XdbPath, err)
	}
	v6Config, err := service.NewV6Config(v6Policy, v6DbPath, 1)
	if err != nil {
		return nil, fmt.Errorf("NewV6Config: %w", err)
	}

	return service.NewIp2Region(v4Config, v6Config)
}

func createSearcher(dbPath string, cachePolicy string) (*xdb.Searcher, error) {
	handle, err := os.OpenFile(dbPath, os.O_RDONLY, 0600)
	if err != nil {
		return nil, fmt.Errorf("open xdb file `%s`: %w", dbPath, err)
	}

	defer handle.Close()

	// verify the xdb file
	// @Note: do NOT call it every time you create a searcher since this will slow down the search response.
	// @see the util.Verify function for details.
	err = xdb.Verify(handle)
	if err != nil {

View on GitHub (pinned to c1a1fc7d59)

Solutions

1. Inspect the wrapped cause (verify, header load, version match, cache load)
2. Point the v6 config at a valid IPv6 xdb database
3. Regenerate or re-download the v6 xdb and retry

When it happens

Trigger: Thrown at binding/golang/main.go:69 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of lionsoul2014/ip2region@c1a1fc7d59 (2026-09-02). Data as JSON: /api/errors/eec4dc07f961a000. Report an issue: GitHub.