DOMDocument加载HTML出错或返回空的主因是编码不匹配、未转义字符及HTML不规范；应预处理HTML、禁用自动补全、正确使用XPath并确保编码一致。
DOMDocument加载HTML时空白或报错DOMDocument::loadHTML(): htmlParseEntityRef: no name
这是最常见的情况：源HTML里有未转义的&、 或自定义实体（比如©在不带DTD时可能被严格解析器拒掉）。DOMDocument默认按XML风格校验，但网页HTML普遍不规范。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 加载前用
mb_convert_encoding()确保输入是UTF-8，再用html_entity_decode()预处理，把&还原成&，避免解析中断 - 调用
libxml_use_internal_errors(true)屏蔽警告，再用libxml_clear_errors()清理，否则后续getElementsByTagName可能返回空 - 用
$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD)禁用自动补全<html><body>结构，防止节点位置偏移
用getElementsByTagName取不到元素，但浏览器能看见
原因通常是DOM树没正确构建：比如HTML碎片缺根节点、<table>里直接写<tr>没包<tbody>，或者JS动态插入的内容根本不在原始HTML里。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先检查
$dom->documentElement是否存在，再确认$dom->getElementsByTagName('div')->length是否为0——如果是，说明加载失败或内容为空 - 对表格类结构，别只查
tr，改用$dom->getElementsByTagName('table')->item(0)->getElementsByTagName('tr')逐层定位 - 如果目标元素在
<script>或<style>里，DOMDocument默认会跳过——得手动提取textContent后二次解析
DOMXPath查询返回空，//div[@class="item"]不生效
XPath在DOMDocument里默认不识别HTML class语义，且大小写敏感、空格敏感。比如class="item active"不能用@class="item"匹配。
Article To Html
下载
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
contains(@class, "item")代替@class="item"，更鲁棒 - 查询前确保
$xpath = new DOMXPath($dom)已绑定正确DOM对象，否则query()返回false - 如果HTML含命名空间（如
xmlns="http://www.w3.org/1999/xhtml"），需注册前缀：$xpath->registerNamespace('h', 'http://www.w3.org/1999/xhtml')，再写//h:div
中文乱码或特殊字符变成问号
根源在于DOMDocument内部编码处理机制：它会把输入强制转成ISO-8859-1再解析，若原始HTML声明了charset=utf-8但没被识别，输出就崩。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 加载前加
<meta charset="utf-8">到HTML字符串开头（哪怕只是临时拼接），比依赖HTTP头更可靠 - 获取文本内容时不用
$node->nodeValue，改用$node->textContent，后者保留编码上下文 - 输出前统一用
mb_convert_encoding($str, 'UTF-8', 'HTML-ENTITIES')兜底，尤其当innerHTML式提取时
DOM解析不是黑盒，每个loadHTML调用背后都有编码推断和树修复逻辑。漏掉LIBXML_HTML_NODEFDTD或忘了清错误，都可能让getElementsByTagName静默失败——这些细节不报错，但结果就是空。
