T-SQL解析XML报soap不表示命名空间错误的解决方法

错误根因 #

T-SQL的XPath引擎不会自动识别XML文档内部声明的命名空间前缀，所有在XPath路径、节点取值逻辑中用到的命名空间前缀，必须通过WITH XMLNAMESPACES子句显式完成URI绑定，否则就会抛出命名空间不存在的错误。
原有代码除了未声明命名空间外，还有两个容易踩的坑：

• GetWebLinkResponse节点声明了默认命名空间http://test.org/，其下所有无前缀的子节点都会自动继承这个命名空间，XPath匹配时必须同步声明
• value()取值时直接写节点名会触发隐式节点遍历，显式指定取(text())[1]性能更优，也能避免多节点匹配的异常

修正后可运行代码 #

DECLARE @xml xml
SET @xml =
'<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <GetWebLinkResponse xmlns="http://test.org/" xmlns:ns2="http://schemas.datacontract.org/2004/07/.Configuration" xmlns:ns3="http://schemas.datacontract.org/2004/07/.Configuration.Results" xmlns:ns4="http://schemas.microsoft.com/2003/10/Serialization/">
         <GetWebLinkResult>
            <ns3:Error>
               <ns2:Id>0</ns2:Id>
               <ns2:Text>Success.</ns2:Text>
            </ns3:Error>
            <ns3:Url>https://example.com&amp;content=true</ns3:Url>
         </GetWebLinkResult>
      </GetWebLinkResponse>
   </soap:Body>
</soap:Envelope>';

-- 声明所有用到的命名空间，必须放在SELECT语句前
WITH XMLNAMESPACES (
    'http://schemas.xmlsoap.org/soap/envelope/' AS soap,
    DEFAULT 'http://test.org/',
    'http://schemas.datacontract.org/2004/07/.Configuration' AS ns2,
    'http://schemas.datacontract.org/2004/07/.Configuration.Results' AS ns3
)
SELECT
    n.value('(ns3:Error/ns2:Id/text())[1]','int') AS ErrorId,
    n.value('(ns3:Error/ns2:Text/text())[1]','varchar(100)') AS ErrorMsg,
    n.value('(ns3:Url/text())[1]','varchar(1000)') AS TargetUrl
FROM @xml.nodes('/soap:Envelope/soap:Body/GetWebLinkResponse/GetWebLinkResult') AS a(n);

使用说明 #

• WITH XMLNAMESPACES必须紧跟在相关查询的最外层，不能嵌套在子查询里单独使用
• 声明的前缀名不需要和XML原文保持一致，只要绑定的URI完全匹配即可，比如可以把soap改成s，后续XPath里统一用s:前缀就能正常匹配
• 如果XML存在多层嵌套的默认命名空间，不建议用DEFAULT关键字，可以给每个默认命名空间分配自定义前缀，避免匹配冲突
• 只要XPath里出现带前缀的节点，必须确保对应前缀已经在命名空间声明块中绑定

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