hyperledger/fabric · error

empty channel group

Error message

empty channel group

What it means

The channel-level Config must contain a ChannelGroup, which is the root of the channel's configuration hierarchy. A nil ChannelGroup means the config struct exists but is empty of channel configuration, so consenter/policy checks cannot proceed and 'empty channel group' is returned.

Source

Thrown at orderer/consensus/smartbft/configverifier.go:100

	switch chdr.Type {
	case int32(common.HeaderType_CONFIG):
		configEnvelope := &common.ConfigEnvelope{}
		if err = proto.Unmarshal(payload.Data, configEnvelope); err != nil {
			return fmt.Errorf("data unmarshalling error: %s", err)
		}
		return cbv.verifyConfigUpdateMsg(envelope, configEnvelope, chdr)
	default:
		return errors.Errorf("unexpected envelope type %s", common.HeaderType_name[chdr.Type])
	}
}

func (cbv *ConfigBlockValidator) checkConsentersMatchPolicy(conf *common.Config) error {
	if conf == nil {
		return fmt.Errorf("empty Config")
	}

	if conf.ChannelGroup == nil {
		return fmt.Errorf("empty channel group")
	}

	if len(conf.ChannelGroup.Groups) == 0 {
		return fmt.Errorf("no groups in channel group")
	}

	if conf.ChannelGroup.Groups["Orderer"] == nil {
		return fmt.Errorf("no 'Orderer' group in channel groups")
	}

	if len(conf.ChannelGroup.Groups["Orderer"].Values) == 0 {
		return fmt.Errorf("no values in 'Orderer' group")
	}

	if conf.ChannelGroup.Groups["Orderer"].Values["Orderers"] == nil {
		return fmt.Errorf("no values in 'Orderer' group")
	}

View on GitHub (pinned to 2736b63f8f)

Solutions

1. Populate Config.ChannelGroup with the full channel config tree (including Orderer/Application groups) before validation
2. Regenerate the config block with the configtxgen/configtxlator tooling rather than hand-assembling it
3. Re-fetch the config block from the ordering service if it appears corrupted

Example fix

// before
conf := &common.Config{} // ChannelGroup nil
// after
conf := &common.Config{ChannelGroup: configtxChannelGroup}

func hasChannelGroup(conf *common.Config) bool {
  return conf != nil && conf.ChannelGroup != nil
}

func hasChannelGroup(c *common.Config) bool { return c != nil && c.GetChannelGroup() != nil }

if err := cbv.ValidateConfig(envelope); err != nil {
  if strings.Contains(err.Error(), "empty channel group") {
    return fmt.Errorf("config missing channel group: %w", err)
  }
  return err
}

When it happens

Trigger: checkConsentersMatchPolicy receiving a *common.Config whose ChannelGroup field is nil — e.g. a Config message that was allocated but never populated from a config block.

Common situations: Programmatically built Config structs with only metadata set; corrupt or truncated config blocks; test fixtures missing the ChannelGroup; protobuf unmarshalling of empty bytes into a Config.

Related errors

• no groups in channel group
• invalid BFT metadata configuration
• unexpected envelope type %s
• empty Config
• no 'Orderer' group in channel groups

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