API返回含未定义命名空间的XML，如何用XSLT转换为HTML？

你遇到的问题其实很常见——API返回的XML里用了命名空间前缀但没正确声明，直接移除命名空间虽然能让本地转换工作，但确实是治标不治本的权宜之计。下面给你两种更健壮的正确处理方式，根据你的实际情况选：

情况1：API返回的XML其实有命名空间声明（只是你没注意到） #

很多时候，命名空间声明是写在根元素（比如你的<root>）上的，只是示例里没体现。比如实际的XML可能长这样：

<root xmlns:entity="http://api.your-service.com/entities" 
      xmlns:g="http://api.your-service.com/values"
      xmlns:ns1="http://api.your-service.com/attributes">
  <entity:Entity ns1:atrib="foo">
    <g:Value>sample data</g:Value>
  </entity:Entity>
</root>

这种情况下，正确的做法是在XSLT的根元素里声明完全相同的命名空间，然后用前缀来选择元素。比如你的XSLT可以这么写：

<xsl:stylesheet version="1.0" 
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                <!-- 复制XML里的命名空间声明，前缀要和XML里一致 -->
                xmlns:entity="http://api.your-service.com/entities"
                xmlns:g="http://api.your-service.com/values"
                xmlns:ns1="http://api.your-service.com/attributes">

  <xsl:template match="/">
    <html>
      <body>
        <h2>Entity Data</h2>
        <xsl:for-each select="root/entity:Entity">
          <div class="entity-item">
            <p>Attribute: <xsl:value-of select="@ns1:atrib"/></p>
            <p>Value: <xsl:value-of select="g:Value"/></p>
          </div>
        </xsl:for-each>
      </body>
    </html>
  </xsl:template>
</xsl:stylesheet>

这样XSLT就能正确识别带命名空间的元素和属性，完全不需要修改原始XML。如果不知道命名空间URI，优先查API的官方文档，或者用XML解析工具（比如Oxygen XML、在线XML验证器）打开返回的XML，就能看到根元素上的命名空间声明。

情况2：API返回的XML确实没有声明命名空间（不合法的XML） #

如果API返回的XML真的是用了前缀但没声明（这其实违反XML规范），那可以用local-name()函数来忽略前缀，直接匹配元素/属性的本地名称：

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <xsl:template match="/">
    <html>
      <body>
        <h2>Entity Data</h2>
        <!-- 匹配根下本地名称为Entity的元素，不管前缀 -->
        <xsl:for-each select="root/*[local-name()='Entity']">
          <div class="entity-item">
            <!-- 匹配本地名称为atrib的属性 -->
            <p>Attribute: <xsl:value-of select="@*[local-name()='atrib']"/></p>
            <!-- 匹配本地名称为Value的子元素 -->
            <p>Value: <xsl:value-of select="*[local-name()='Value']"/></p>
          </div>
        </xsl:for-each>
      </body>
    </html>
  </xsl:template>
</xsl:stylesheet>

这种方法不需要关心命名空间URI，适合处理不合法的XML，但要注意：如果XML里有不同命名空间下的同名元素，这种方法会把它们都匹配到，可能导致错误。

为什么移除命名空间是权宜之计？ #

XML里的命名空间是用来区分不同语义的同名元素的——比如entity:Entity和other:Entity是完全不同的元素。移除命名空间会破坏这种语义区分，一旦API后续调整命名空间规则（比如添加新的命名空间元素），你的转换逻辑就会失效。而上面两种方法都是基于XML的规范来处理，更健壮、更易维护。

内容的提问来源于stack exchange，提问作者user2158094