hyperledger/fabric · error

no groups in channel group

Error message

no groups in channel group

What it means

A valid channel Config's ChannelGroup must contain sub-groups (typically 'Orderer' and/or 'Application'). If Groups is empty the config tree has no organizational units, so the verifier cannot locate the Orderer group holding the consenters and rejects with 'no groups in channel group'.

Solutions

1. Include at least the required sub-groups (Orderer, Application, Consortiums as applicable) in ChannelGroup.Groups
2. Generate the channel config with configtxgen so the standard group hierarchy is present
3. If migrating/upgrading, re-derive the config from the current channel's latest config block

Example fix

// before
channelGroup := &common.ConfigGroup{} // no groups
// after
channelGroup := &common.ConfigGroup{
  Groups: map[string]*common.ConfigGroup{
    "Orderer": ordererGroup,
    "Application": applicationGroup,
  },
}

func hasGroups(conf *common.Config) bool {
  return conf != nil && conf.ChannelGroup != nil && len(conf.ChannelGroup.Groups) > 0
}

func hasSubGroups(c *common.Config) bool {
  return c != nil && c.GetChannelGroup() != nil && len(c.GetChannelGroup().GetGroups()) > 0
}

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

When it happens

Trigger: checkConsentersMatchPolicy receiving a Config whose ChannelGroup is non-nil but has an empty Groups map — e.g. ChannelGroup was created with only ModPolicy or version fields set.

Common situations: Partially constructed config from custom tooling; config blocks generated without the Orderer/Application subtrees; test fixtures with a bare &common.Config{ChannelGroup: &common.ConfigGroup{}}.

Related errors

• empty channel group
• block validation policy should be a signature policy
• empty Config
• invalid BFT metadata configuration
• invalid consensus type property in config

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

Appendix: source

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

			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")
	}

	ords := &common.Orderers{}
	if err := proto.Unmarshal(conf.ChannelGroup.Groups["Orderer"].Values["Orderers"].Value, ords); err != nil {
		return err
	}

View on GitHub (pinned to 2736b63f8f)