Indentation errors are the usual culprit

YAML fails loudly on tabs vs spaces and nested maps. A formatter plus validator catches issues before kubectl or your CI does.

Convert when teams disagree

Some tools want JSON; others ship YAML. Convert either way in YAML Formatter, then re-validate.