vitessio/vitess · error

failed to get tablet

Error message

failed to get tablet %s: %w

What it means

RefreshState (ReparentTable-related) first resolves the tablet alias via topo.GetTablet. If the alias does not exist in the topology, the lookup error is wrapped with the alias and returned to the caller.

Solutions

1. List valid tablets with `vtctldclient GetTablets` and use the correct alias
2. Re-check alias format (cell-uid format, e.g. zone1-0000000100)
3. If the tablet exists but topo entry is missing, re-register it (RestartTablet / vttablet restart)
4. Fix automation scripts referencing deleted tablets

Example fix

// before
vtctldclient RefreshState zone1-0000999999  # not in topo
// after
vtctldclient GetTablets | grep zone1
vtctldclient RefreshState zone1-0000000100

// validate the alias exists before calling RefreshState
tablets, _ := vtctld.GetTablets(ctx)
if !slices.ContainsFunc(tablets, func(t Tablet) bool {
    return t.Alias == req.Alias
}) {
    return fmt.Errorf("unknown tablet alias %s", req.Alias)
}

// handle missing tablet distinctly from RPC failures
var notFound bool
if errors.As(err, &topoErr) && errors.Is(topoErr, topo.ErrNodeNotFound) {
    notFound = true // skip or re-register tablet
}

When it happens

Trigger: vtctldclient RefreshTablet / ReparentTable-style RPC with a tablet alias that was scrapped, deleted, mistyped, or whose topo entry was removed.

Common situations: Stale alias in scripts after tablet decommission; typo in alias; topo server data cleaned up (e.g. after keyspace removal); cross-cell alias confusion.

Related errors

• cannot remove cell from shard /
• failed to delete tablet
• failed to get shard / /
• failed to GetCellInfoNames
• failed to GetCellsAliases for cluster

AI-assisted analysis of vitessio/vitess@01a25a7d17 (2026-09-01). Data as JSON: /api/errors/083247c1c21cd5ad. Report an issue: GitHub.

Appendix: source

Thrown at go/vt/vtctl/grpcvtctldserver/server.go:3412

// RefreshState is part of the vtctldservicepb.VtctldServer interface.
func (s *VtctldServer) RefreshState(ctx context.Context, req *vtctldatapb.RefreshStateRequest) (resp *vtctldatapb.RefreshStateResponse, err error) {
	span, ctx := trace.NewSpan(ctx, "VtctldServer.RefreshState")
	defer span.Finish()

	defer panicHandler(&err)

	if req.TabletAlias == nil {
		err = vterrors.Errorf(vtrpcpb.Code_INVALID_ARGUMENT, "RefreshState requires a tablet alias")
		return nil, err
	}

	ctx, cancel := context.WithTimeout(ctx, topo.RemoteOperationTimeout)
	defer cancel()

	tablet, err := s.ts.GetTablet(ctx, req.TabletAlias)
	if err != nil {
		err = fmt.Errorf("failed to get tablet %s: %w", topoproto.TabletAliasString(req.TabletAlias), err)
		return nil, err
	}

	if err = s.tmc.RefreshState(ctx, tablet.Tablet); err != nil {
		return nil, err
	}

	return &vtctldatapb.RefreshStateResponse{}, nil
}

// RefreshStateByShard is part of the vtctldservicepb.VtctldServer interface.
func (s *VtctldServer) RefreshStateByShard(ctx context.Context, req *vtctldatapb.RefreshStateByShardRequest) (resp *vtctldatapb.RefreshStateByShardResponse, err error) {
	span, ctx := trace.NewSpan(ctx, "VtctldServer.RefreshStateByShard")
	defer span.Finish()

	defer panicHandler(&err)

	if req.Keyspace == "" {

View on GitHub (pinned to 01a25a7d17)