lionsoul2014/ip2region · error

failed to create the %dth searcher: %w

Error message

failed to create the %dth searcher: %w

What it means

Go pool construction error: creating the i-th underlying xdb.Searcher from the config failed mid-loop; the pool auto-closes already-created searchers and wraps the failure with the 1-based searcher index.

Source

Thrown at binding/golang/service/searcher_pool.go:61

		pool:   make(chan *xdb.Searcher, config.searchers+1),

		closing:   make(chan struct{}, 1),
		loanCount: 0,
	}

	// error closing
	defer func() {
		if eExit {
			spObj.Close()
		}
	}()

	// check and create all the searchers
	for i := 0; i < config.searchers; i++ {
		searcher, err := xdb.NewSearcher(config.ipVersion, config.xdbPath, config.vIndex, config.cBuffer)
		if err != nil {
			eExit = true // active the auto error closing
			return nil, fmt.Errorf("failed to create the %dth searcher: %w", i+1, err)
		}

		// push the search to the pool
		spObj.pool <- searcher
	}

	return spObj, nil
}

// get the loaned count
func (sp *SearcherPool) LoanCount() int {
	return int(atomic.LoadInt32(&sp.loanCount))
}

func (sp *SearcherPool) BorrowSearcher() *xdb.Searcher {
	// @Note: still accept searcher borrow while closing,
	// return nil directly once the pool was closed to avoid blocking forever.
	select {

View on GitHub (pinned to c1a1fc7d59)

Solutions

1. Inspect the wrapped error for the per-searcher cause (bad xdb path, permissions, corrupt file)
2. Fix the underlying xdb/config issue and retry pool creation
3. Use the content cache policy to avoid repeated file opens

When it happens

Trigger: Thrown at binding/golang/service/searcher_pool.go:61 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/4396161ccabfdf55. Report an issue: GitHub.