hyperledger/fabric · error

invalid configuration for collection criteria %#v

Error message

invalid configuration for collection criteria %#v

What it means

RetrieveCollectionConfigPackageFromState reads the serialized collection config package from the ledger state and parses it via ParseCollectionConfig. This (wrapped) error is returned when that parsing fails — the bytes stored on the ledger do not constitute a valid CollectionConfigPackage, so the collection criteria cannot be resolved. The error wraps the underlying parse error with the failing CollectionCriteria for context.

Solutions

1. Check the wrapped cause (errors.Cause) to see the actual parse failure and fix the producing chaincode so it stores a valid marshaled CollectionConfigPackage
2. Re-commit the chaincode definition/collection config so a correct package is written to state
3. If ledger corruption is suspected, restore from a known-good backup or resync from peers

Example fix

// before
state.PutState(key, someRawJSONBytes) // stored non-proto bytes

// after
ccpBytes, err := proto.Marshal(collectionConfigPackage)
if err != nil { return err }
state.PutState(key, ccpBytes)

// before reading, verify stored bytes parse
if len(cb) == 0 {
  return errors.New("no collection config bytes in state for key")
}
if _, err := privdata.ParseCollectionConfig(cb); err != nil {
  return fmt.Errorf("state holds invalid collection config: %w", err)
}

func isParsableCollectionConfig(b []byte) bool {
  _, err := privdata.ParseCollectionConfig(b)
  return err == nil
}

conf, err := RetrieveCollectionConfigPackageFromState(cc, state)
if err != nil {
  log.Printf("wrapped cause: %v", errors.Cause(err))
  return fmt.Errorf("collection config unreadable for %+v: %w", cc, err)
}

When it happens

Trigger: Reading collection config from a transaction's write set or state where the stored bytes are corrupt, were written by an incompatible Fabric version, or were never valid collection config — hit from validateRWSetAndCollection during validation of private data.

Common situations: Ledger state produced by a chaincode that stored raw bytes instead of a marshaled CollectionConfigPackage, chaincode upgrades changing the stored config format, ledger corruption after crash/restore from backup.

Related errors

• Collection config access policy is nil
• Collection config policy is nil
• Nil config passed to collection setup
• Block data is empty
• block data size( ) is different from Tx filter size( )

AI-assisted analysis of hyperledger/fabric@2736b63f8f (2026-09-04). Data as JSON: /api/errors/1e3d61a0f8780e92. Report an issue: GitHub.

Appendix: source

Thrown at core/common/privdata/store.go:113

			return nil, errors.WithMessagef(err, "could not retrieve query executor for collection criteria %#v", cc)
		}
		defer qe.Done()
	}
	return c.ccInfoProvider.AllCollectionsConfigPkg(cc.Channel, cc.Namespace, qe)
}

// RetrieveCollectionConfigPackageFromState retrieves the collection config package from the given key from the given state
func RetrieveCollectionConfigPackageFromState(cc CollectionCriteria, state State) (*peer.CollectionConfigPackage, error) {
	cb, err := state.GetState("lscc", BuildCollectionKVSKey(cc.Namespace))
	if err != nil {
		return nil, errors.WithMessagef(err, "error while retrieving collection for collection criteria %#v", cc)
	}
	if cb == nil {
		return nil, NoSuchCollectionError(cc)
	}
	conf, err := ParseCollectionConfig(cb)
	if err != nil {
		return nil, errors.Wrapf(err, "invalid configuration for collection criteria %#v", cc)
	}
	return conf, nil
}

// ParseCollectionConfig parses the collection configuration from the given serialized representation.
func ParseCollectionConfig(colBytes []byte) (*peer.CollectionConfigPackage, error) {
	collections := &peer.CollectionConfigPackage{}
	err := proto.Unmarshal(colBytes, collections)
	if err != nil {
		return nil, errors.WithStack(err)
	}

	return collections, nil
}

// RetrieveCollectionConfig retrieves a collection's config
func (c *SimpleCollectionStore) RetrieveCollectionConfig(cc CollectionCriteria) (*peer.StaticCollectionConfig, error) {
	return c.retrieveCollectionConfig(cc, nil)

View on GitHub (pinned to 2736b63f8f)