故障排除

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /v1.0.0.0/cn/docs/08-troubleshooting/index.md.

常见问题及解决方案

“该文件不是有效的 DNS 调试日志文件”

• 确保你正在转换的是实际的 DNS 服务器调试日志。
• 文件应以 Message logging started at 开头或包含 DNS 查询条目。
• 如果你确定文件有效但头部不同，请使用 -SkipHeaderValidation。

输出文件为空或不完整

• 确认输入文件包含有效的日志条目。
• 如果没有发生查询，有些日志可能只包含头部信息。
• 验证日志文件未损坏且包含实际的查询数据。

处理速度非常慢

• 确保有足够的内存且磁盘负载不高。
• 考虑处理较小的日志文件。
• 考虑使用 -CompressOutput 并结合计划任务处理较小批次。

“访问被拒绝”错误

• 以具有读取源日志文件和写入目标目录权限的身份运行 PowerShell。
• DNS 日志文件可能需要管理员权限。

压缩后的输出文件比预期大

• 含有许多唯一值的日志压缩效率较低；这是正常现象。
• ZIP 压缩通常仍能大幅减小文件大小。

统计文件与预期不符

• 确认你使用了 -OutputType Both 或 -OutputType Statistic。
• 统计数据是汇总计数（按天分组），因此值表示总计。

报告问题

如果遇到此处未涵盖的问题：

1. 确认你使用的是模块的最新版本。
2. 检查 GitHub Issues 是否有类似问题。
3. 收集诊断信息：
   • PowerShell 版本（$PSVersionTable）
   • 模块版本（Get-Module DNSServer.DebugLogParser）
   • 示例日志文件（如果可能）
   • 完整的错误信息和堆栈跟踪
4. 在 GitHub 上新建 issue 并提供详细信息。