jackc/pgx · error

cannot scan NULL into %T

Error message

cannot scan NULL into %T

What it means

Error "cannot scan NULL into %T" thrown in jackc/pgx.

Source

Thrown at pgtype/qchar.go:79

	case TextFormatCode, BinaryFormatCode:
		switch target.(type) {
		case *byte:
			return scanPlanQcharCodecByte{}
		case *rune:
			return scanPlanQcharCodecRune{}
		case *string:
			return scanPlanQcharCodecString{}
		}
	}

	return nil
}

type scanPlanQcharCodecByte struct{}

func (scanPlanQcharCodecByte) Scan(src []byte, dst any) error {
	if src == nil {
		return fmt.Errorf("cannot scan NULL into %T", dst)
	}

	if len(src) > 1 {
		return fmt.Errorf(`invalid length for "char": %v`, len(src))
	}

	b := dst.(*byte)
	// In the text format the zero value is returned as a zero byte value instead of 0
	if len(src) == 0 {
		*b = 0
	} else {
		*b = src[0]
	}

	return nil
}

type scanPlanQcharCodecRune struct{}

View on GitHub (pinned to ec1a0befd2)

When it happens

Trigger: Thrown at pgtype/qchar.go:79 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of jackc/pgx@ec1a0befd2 (2026-08-04). Data as JSON: /data/errors/e646402fa0d5b176.json. Report an issue: GitHub.