XML参数必须声明为XML类型，不能用VARCHAR/NVARCHAR；否则.nodes()等方法报错“Cannot call methods on varchar”；应用层需用SqlDbType.Xml绑定；注意命名空间、属性名及非法字符处理。
XML参数声明必须用XML类型，不能用VARCHAR或NVARCHAR
SQL Server 对 XML 类型有专门的解析能力，如果把 XML 数据当成字符串传入，后续调用 .nodes() 或 .value() 会直接报错：Cannot call methods on varchar。哪怕内容看起来是合法 XML，只要类型不对，就无法使用原生 XML 方法。
常见错误写法：
CREATE PROCEDURE BadProc @xmlData VARCHAR(MAX) AS ...
正确写法：
CREATE PROCEDURE GoodProc @xmlData XML AS ...
-
@xmlData必须声明为XML，否则@xmlData.nodes(...)语法不识别 - 传入时若来源是应用层（如 C#），也要确保用
SqlDbType.Xml而非SqlDbType.VarChar绑定参数 - 如果 XML 内容含非法字符（如未转义的
&、），SQL Server 会在赋值给 <code>XML变量时立即抛出XML parsing: line X, character Y, illegal name character
用.nodes()比OPENXML更简洁，且无需手动管理句柄
OPENXML 需配合 sp_xml_preparedocument 和 sp_xml_removedocument，容易漏掉清理导致内存泄漏；而 .nodes() 是原生 XQuery 方法，自动管理生命周期，推荐新项目优先使用。
例如解析 <Root><Item id="1" name="A"/><Item id="2" name="B"/></Root>：
SELECT
T.c.value('@id', 'INT') AS ID,
T.c.value('@name', 'NVARCHAR(50)') AS Name
FROM @xmlData.nodes('/Root/Item') AS T(c)
-
.nodes()返回行集，可直接 JOIN 或 INSERT，不用临时表 - 路径表达式区分大小写，
/root/item不匹配<Root><Item> - 属性用
@attr，子元素用ElementName，文本内容用text()[1] - 如果 XML 命名空间存在，必须先用
WITH XMLNAMESPACES声明，否则.nodes()返回空
批量插入时慎用游标，INSERT ... SELECT性能更好
知识库中多个示例用了游标逐行 FETCH，这在处理几百条以上数据时明显变慢。SQL Server 对集合操作优化充分，应尽量避免游标。
错误示范（游标）：
DECLARE person_cursor CURSOR FOR SELECT ... FROM @xml.nodes(...) ...
推荐写法（单次 INSERT）：
INSERT INTO Persons (ID, FirstName, LastName)
SELECT
T.c.value('ID[1]', 'INT'),
T.c.value('FirstName[1]', 'NVARCHAR(50)'),
T.c.value('LastName[1]', 'NVARCHAR(50)')
FROM @xmlData.nodes('/Persons/Person') AS T(c)
- 游标在 XML 解析场景下几乎无优势，反而增加锁时间和资源占用
- 若需校验或转换逻辑（如空值转默认值），可在 SELECT 中用
ISNULL(T.c.value(...), 'N/A') - 注意
.value()的第二个参数必须与目标列类型兼容，否则插入时报Cannot convert...
XML 大于 2MB 时可能触发隐式转换失败
SQL Server 默认对 XML 类型变量有内部大小限制，超大 XML（比如 >2MB）在某些版本或配置下会静默截断或报 XML datatype instance has too many levels of nested nodes。
- 检查实际传入长度：
DATALENGTH(@xmlData)，不是LEN() - 若确定要处理大 XML，建议在应用层拆分，或改用
VARBINARY(MAX)+ 客户端解析 - SQL Server 2019 默认支持最大 2GB XML，但内存压力大时仍可能因工作内存不足失败
-
sp_xml_preparedocument在大文档下更易出错，且句柄占用内存不释放快，.nodes()更稳妥
XML 类型——这些错误不会编译失败，但一执行就崩。 
