🔧 Error: Invalid XML Character

The Error Signature

XML parser specifications require strict conformity. Encountering unescaped structural symbols like an ampersand (&) will halt the parser immediately, throwing validation errors.

XML Parsing Error: xmlParseEntityRef: no name
    Line Number 8, Column 22:
    <link href="http://site.com?q=1&amp;p=2" />
                         ^ (Error: Raw '&' character)

Common Causes & Code Examples

1. Unescaped Ampersand (&)

Storing a raw ampersand in descriptions or text values will fail:

<store>
  <description>Buy computer parts & software</description>
</store>

To resolve, replace the symbol with its entity representation (&):

<store>
  <description>Buy computer parts &amp; software</description>
</store>

2. Unescaped Less-Than Symbol (<)

Since < declares tag initialization, using it to represent mathematical inequalities (e.g. x < y) will break parsing. Replace with <.

3. Invalid Unicode/ASCII Characters

XML documents only support specific character ranges. Control bytes, null characters, or invalid UTF-8 sequences will trigger validation crashes.

Resolution Checklist

• Locate the character: Check the line and column number from the console logs.
• Escape manually: Replace illegal characters with their XML character reference values.
• Use CDATA Wrapper: For long blocks of code or plain text, wrap the contents in <![CDATA[ ... ]]> to instruct the parser to ignore entities.