What causes "channel %s not found" in hyperledger/fabric?

Verify the peer has joined the channel (peer channel list) and join it if not.

channel %s not found

Error message

channel %s not found

What it means

identityDeserializerMgr.Deserializer returns the MSP identity deserializer registered for a channel via mgmt.GetDeserializers(). If no deserializer is registered for the given channelID — meaning the peer is not a member of / has not initialized that channel — this error is returned.

Source

Thrown at core/peer/deliverevents.go:453

			txPvtRWSet.NsPvtRwset = append(txPvtRWSet.NsPvtRwset, &rwset.NsPvtReadWriteSet{
				Namespace:          namespaceName,
				CollectionPvtRwset: cols,
			})
		}

		pvtDataMap[seq.seq] = txPvtRWSet
	}
	return pvtDataMap
}

// identityDeserializerMgr implements an IdentityDeserializerManager
// by routing the call to the msp/mgmt package
type identityDeserializerMgr struct{}

func (*identityDeserializerMgr) Deserializer(channelID string) (msp.IdentityDeserializer, error) {
	id, ok := mgmt.GetDeserializers()[channelID]
	if !ok {
		return nil, errors.Errorf("channel %s not found", channelID)
	}
	return id, nil
}

// collPolicyChecker is the default implementation for CollectionPolicyChecker interface
type collPolicyChecker struct{}

// CheckCollectionPolicy checks if the CollectionCriteria meets the policy requirement
func (cs *collPolicyChecker) CheckCollectionPolicy(
	blockNum uint64,
	ccName string,
	collName string,
	cfgHistoryRetriever ledger.ConfigHistoryRetriever,
	deserializer msp.IdentityDeserializer,
	signedData *protoutil.SignedData,
) (bool, error) {
	configInfo, err := cfgHistoryRetriever.MostRecentCollectionConfigBelow(blockNum, ccName)
	if err != nil {

View on GitHub (pinned to 2736b63f8f)

Solutions

Verify the peer has joined the channel (peer channel list) and join it if not.
Confirm the channelID string exactly matches an existing channel.
At startup, wait for channel/MSP initialization before delivering blocks for that channel.
Check peer logs for channel MSP setup failures that prevented deserializer registration.

Example fix

// before
id, err := deserializerMgr.Deserializer("yourchannel") // peer not joined
// after
if _, ok := mgmt.GetDeserializers()["yourchannel"]; !ok {
  return errors.New("join the peer to 'yourchannel' before requesting data")
}
id, err := deserializerMgr.Deserializer("yourchannel")

Defensive patterns

Strategy: type-guard

Validate before calling

if _, ok := mgmt.GetDeserializers()[channelID]; !ok {
  return fmt.Errorf("channel %s unknown: peer not joined", channelID)
}

Type guard

func channelKnown(channelID string) bool {
  _, ok := mgmt.GetDeserializers()[channelID]
  return ok
}

Try / catch

id, err := mgr.Deserializer(chID)
if err != nil && strings.Contains(err.Error(), "not found") {
  return fmt.Errorf("join channel %s first: %w", chID, err)
}

Prevention

Join the peer before delivering its blocks
Validate channel names in scripts
Wait for MSP initialization at startup

When it happens

Trigger: Calling Deserializer(channelID) with a channel the peer hasn't joined or that hasn't finished MSP initialization — e.g., during collection policy checks on a block from an unknown channel.

Common situations: Deliver client requesting private data on a channel this peer never joined; race where the deliver handler runs before channel MSPs load at peer startup; typo in channel name; channel deleted/recreated with a different ID.

Related errors

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