Validar XML online
Cole seu XML neste validador e veja se o documento é bem formado. Se houver um erro, você vê a linha e a coluna do primeiro, explicado em palavras simples. Com um esquema XSD, a estrutura também é conferida, e um documento válido volta formatado. Tudo roda no seu navegador, então seu XML não é enviado.
Como validar XML: passo a passo
- Clique em Colar XML para ler a área de transferência na caixa XML, ou cole o texto manualmente. Ao colar, o documento é conferido na hora.
- Clique em Validar para conferir de novo depois de editar o texto.
- Leia o resultado abaixo do botão. Uma caixa verde XML válido significa que o documento é bem formado. Uma caixa vermelha XML mal formado mostra um erro.
- Em caso de erro, a caixa traz a linha e a coluna, um trecho dessa linha com uma seta sob a coluna e um botão Mostrar no editor. O editor também rola até a linha.
- Corrija o primeiro erro e confira de novo. Só o primeiro é mostrado, de propósito: os seguintes costumam ser consequência dele, como uma tag de fechamento que faltou.
Para validar um arquivo XML, o único caminho é colar, porque não há seletor de arquivos. Abra o arquivo em qualquer editor de texto, copie tudo e cole na caixa.
O que é um XML bem formado
A primeira conferência trata só da sintaxe. Um documento é bem formado quando segue estas regras:
- Existe um único elemento raiz que contém todo o resto.
- Cada tag de abertura tem sua tag de fechamento, na ordem certa, ou se fecha sozinha, como
<br/>. - Os valores dos atributos ficam entre aspas, como em
id="7", e um atributo aparece uma só vez por tag. - Um & ou um < literal no texto é escrito como
&ou<. - Um comentário não contém dois hifens seguidos, e uma seção CDATA é fechada com
]]>. - Um prefixo de namespace como
xs:é declarado comxmlns:xs="..."nessa tag ou em uma tag pai.
Bem formado não é o mesmo que válido. Válido significa que o documento também segue um esquema, e é para isso que serve a opção de XSD mais abaixo.
Erro no XML: os mais comuns e como corrigir
Cada erro é explicado em uma frase, e não com a mensagem bruta do analisador. Estes são os que você mais vai encontrar:
- A tag de fechamento não corresponde à de abertura: falta uma tag de fechamento, ela está escrita errado ou fora de ordem. Feche as tags na ordem inversa da abertura.
- O documento termina antes de uma tag ser fechada: falta a última tag de fechamento, ou o texto colado foi cortado. Adicione a tag que falta ou cole o documento inteiro.
- Há conteúdo depois do elemento raiz: um segundo elemento raiz ou texto após a raiz. Envolva tudo em um único elemento pai.
- Uma entidade não está definida: em geral é uma entidade HTML como
ou um & solto. Use ou escreva&. - O valor de um atributo precisa estar entre aspas: aparece
id=7em vez deid="7". Coloque as aspas. - Um atributo aparece duas vezes na mesma tag: apague um deles.
- Um prefixo é usado, mas nunca declarado: falta o
xmlns:prefixo. Adicione a declaração na tag ou em uma tag pai. - A declaração
<?xml ...?>só é permitida bem no início: antes dela há uma linha em branco, um espaço ou um comentário. Remova o que vem antes. - Um comentário contém dois hifens seguidos: reescreva o comentário.
- Uma seção CDATA nunca é fechada: falta o
]]>. Adicione.
Caracteres proibidos em XML, como caracteres de controle soltos, também são apontados, assim como tags de abertura que nunca terminam e comentários que nunca são fechados. Se você precisa corrigir erro XML, comece sempre pelo primeiro da lista.
Validar XML com XSD
Um documento bem formado ainda pode estar errado para o seu objetivo: um texto onde deveria haver um número, um elemento obrigatório faltando ou um elemento no lugar errado. Um esquema descreve o que é permitido, e o validador pode conferir o documento contra ele.
- Clique no botão de engrenagem, Opções avançadas.
- Cole seu esquema em Esquema XSD (opcional). Deixe vazio se quiser conferir só se o documento é bem formado.
- Cole o XML na caixa XML e clique em Validar.
Se o XML não corresponder, o resultado tem o título «Não corresponde ao esquema» com o número de erros e lista até 100 deles. Cada um traz o XPath do elemento, como /note/n[1], ou /note/@id para um atributo, depois uma frase clara e a linha. As frases cobrem:
- um valor do tipo errado, por exemplo texto onde se espera
xs:int; - um valor que viola uma restrição: padrão, enumeração, comprimento, mínimo ou máximo;
- um elemento filho obrigatório que falta, ou um elemento que não é esperado ali;
- um atributo não permitido, ou um atributo obrigatório que falta;
- um elemento raiz que o esquema não declara.
Quando o problema está no esquema, e não no seu XML, ele ganha uma caixa própria: O esquema XSD não é um XML bem formado ou Não é possível usar o esquema XSD, e o XML não é conferido contra ele. Um esquema que importa ou inclui outro arquivo não pode ser usado, porque nada é baixado. Coloque todas as definições em um único XSD. O XSD 1.0 é compatível.
Formatar XML
Quando o documento é válido, aparece a seção XML formatado com um botão Copiar acima do resultado. Escolha a largura em Recuo, nas Opções avançadas: 2 espaços, 4 espaços ou tabulação. O resultado se atualiza na hora. A formatação segue o xmllint --format, então é previsível:
- O recuo é aplicado de novo do zero, e o texto formado só por espaços entre as tags é descartado.
- O texto dentro de um elemento é mantido como você escreveu. Em conteúdo misto como
<p><b>a</b> <i>b</i></p>, o espaço entre as tags pode se perder. - Comentários, seções CDATA e o DOCTYPE são mantidos.
- A declaração XML fica exatamente como você escreveu, e não é adicionada se você não tinha nenhuma.
Uma saída muito longa é mostrada cortada, com uma nota dizendo quantas linhas aparecem. Copiar sempre entrega o documento inteiro.
Arquivos XML grandes e limites
A conferência roda em um Web Worker em segundo plano. Documentos muito grandes demoram principalmente porque o navegador precisa desenhar tanto texto na caixa: nos testes, um documento de 50 MB com mais de 600.000 linhas levou cerca de 30 segundos entre colar e ver o resultado, e um de 20 MB cerca de 11 segundos. O limite é de 120 milhões de caracteres. Acima disso, você é convidado a colar um trecho menor.
O que não é conferido: não há validação de DTD, e entidades e arquivos externos não são carregados, porque nada é baixado. Só há suporte a XSD 1.0. Uma codificação declarada, como ISO-8859-1 ou UTF-16, é ignorada, porque o texto colado já é Unicode. Documentos que definem entidades que se expandem para texto demais são recusados, assim como tags aninhadas em mais de 2048 níveis.
Perguntas frequentes
Como verificar XML para saber se é bem formado?
Cole o XML na caixa "XML" e clique em "Validar". Uma caixa verde "XML válido" significa que todas as tags estão fechadas e aninhadas corretamente e que o documento tem um elemento raiz. Uma caixa vermelha "XML mal formado" mostra o primeiro erro em palavras simples, com a linha e a coluna.
O que é um XML bem formado?
É um XML que segue as regras de sintaxe: um elemento raiz, cada tag de abertura fechada por uma tag de fechamento na ordem certa, valores de atributos entre aspas, nenhum atributo repetido em uma tag e caracteres especiais como & escritos como &. Um analisador recusa um documento que quebre qualquer uma dessas regras.
Qual é a diferença entre XML bem formado e XML válido?
Bem formado significa que a sintaxe está correta. Válido, no sentido estrito, significa também que o documento segue um esquema (um XSD ou um DTD) que diz quais elementos e valores são permitidos. Aqui, "XML válido" significa apenas bem formado quando a caixa de XSD está vazia, e bem formado e de acordo com o esquema quando você cola um XSD. A validação de DTD não é compatível.
O que significa "opening and ending tag mismatch" em XML?
Uma tag de fechamento não corresponde à tag que está aberta naquele ponto, então falta uma tag de fechamento, ela está escrita errado ou duas tags se sobrepõem. Este validador diz assim: A tag de fechamento não corresponde à tag de abertura da linha 1. Corrija o primeiro erro citado e confira de novo, porque os seguintes costumam ser consequência dele.
Por que o XML diz "extra content at the end of the document"?
Algo vem depois do fim do elemento raiz, quase sempre um segundo elemento raiz, por exemplo dois registros colados um depois do outro. Um documento XML tem exatamente um elemento raiz. Envolva os registros em um único elemento pai, ou cole um registro por vez.
Por que o XML diz que a entidade nbsp não está definida?
é uma entidade HTML. O XML só predefine <, >, &, " e '. Use a referência de caractere para um espaço não separável, digite o próprio caractere ou declare a entidade em um DTD. Um & solto que não inicia uma entidade deve ser escrito como &.
O que significa "XML declaration allowed only at the start of the document"?
A declaração <?xml ...?> só é permitida bem no início do documento, sem nada antes. Em geral há uma linha em branco, um espaço ou um comentário na frente. Remova o que estiver antes da declaração e o erro some.
Meu XML é enviado quando eu o valido?
Não. A conferência roda no seu navegador, no seu dispositivo, e nada é enviado nem salvo. O mesmo vale para um esquema XSD que você cola.