应使用 ZipInputStream 定位 XML 条目后流式解析，避免直接传 ZIP 流给 DocumentBuilder；优先选 SAXParser，注意 entry 边界、编码一致及 closeEntry() 调用。
用 ZipInputStream 读取 ZIP 内的 XML，别直接 new DocumentBuilder
Java 原生 XML 解析器（DocumentBuilder、SAXParser）默认不识别 ZIP 流——它只认 InputStream 或文件路径。如果你把 ZipInputStream 直接塞给 parse()，大概率会报 org.xml.sax.SAXParseException: Content is not allowed in prolog，因为 ZIP 流开头是 ZIP header，不是 XML 声明。
正确做法是：先用 ZipInputStream.getNextEntry() 定位到目标 XML 条目，再把这个 entry 对应的流（仍是 ZipInputStream）传给 XML 解析器。注意：这个流必须是 *entry 打开后* 的流，不能跳过 entry 头部。
- 务必在调用
parse()前检查zipInputStream.available() > 0，避免空 entry 导致解析器读到 ZIP 元数据 - 不要用
ZipInputStream.readAllBytes()全局加载——大 XML 会 OOM；应保持流式解析（SAX或StAX更稳妥） -
ZipEntry名称含路径（如"data/config.xml"），匹配时建议用getName().endsWith(".xml")而非equals()
用 SAXParser 解析 ZIP 内 XML，避免内存爆炸
XML 文件一旦超过几 MB，用 DocumentBuilder.parse() 加载整个 DOM 树，很容易触发 OutOfMemoryError。而 SAXParser 是事件驱动、只进不回的流式解析，天然适合 ZIP 中的 XML 流。
关键点在于：SAX 不关心输入流来源，只要它是有效 XML 字节流。所以你只需确保传入的是「已定位到 XML entry 的 ZipInputStream」。
立即学习“Java免费学习笔记（深入）”；
- 注册
DefaultHandler时，startElement()和characters()回调里别缓存全部文本——按需提取字段，及时丢弃 - 如果 ZIP 里有多个 XML，每次处理完一个 entry 后，**必须调用
zipInputStream.closeEntry()**，否则下一个getNextEntry()可能失败或读错数据 - 别在 handler 里调用
zipInputStream.close()——它属于外层资源管理，应在 try-with-resources 里统一关
ZipInputStream 和 BufferedInputStream 套用时的坑
有人为了提速，会给 ZipInputStream 包一层 BufferedInputStream，比如 new BufferedInputStream(new ZipInputStream(...))。这会导致 ZIP 解析失败——ZipInputStream 内部依赖底层流的字节对齐和 mark/reset 行为，加缓冲层会破坏 ZIP entry 边界识别。
官方文档明确说：ZipInputStream 已自带内部缓冲，不需要额外包装。
- 正确写法：
new ZipInputStream(Files.newInputStream(zipPath))或new ZipInputStream(inputStream)（原始流即可） - 如果原始流本身很慢（如网络流），应优化源头（加 HTTP 缓存、预下载），而不是在 ZIP 层叠 Buff
- 调试时可用
zipInputStream.getNextEntry().getCompressedSize()快速确认是否真读到了 XML entry
中文字符乱码？检查 ZipEntry 的编码和 XML 声明一致性
ZIP 规范本身不强制编码，JDK 默认用 UTF-8 解析 entry 名，但老工具打包时可能用 GBK 或 CP437。如果 XML 内容是中文，且解析后变成 ???，问题往往不在 XML 解析器，而在 ZIP 条目名或内容读取阶段就错了。
XML 自身的 <?xml version="1.0" encoding="GBK"?> 声明必须和实际字节编码一致；而 ZipInputStream 读取 entry 内容时，用的是原始字节流，不涉及编码转换——所以乱码通常发生在你用 InputStreamReader 包装时指定了错误 charset。
- 推荐做法：用
InputSource显式指定编码，例如new InputSource(new ByteArrayInputStream(bytes))配合setEncoding("GBK") - 更稳方案：改用
ZipFile（而非ZipInputStream），它支持传入Charset参数，比如new ZipFile(file, Charset.forName("GBK")) - 验证手段：把 entry 内容先
Files.write(Paths.get("debug.xml"), bytes)写出，用编辑器打开看是否正常
最麻烦的其实是 ZIP 里嵌套 ZIP 或加密条目——这些 ZipInputStream 原生不支持，得换 Apache Commons Compress 或手动解密。普通场景下，盯紧 entry 定位、流生命周期、编码三件事，基本不会翻车。
