# 故障排除

LLMS index: [llms.txt](/v1.0.0.0/llms.txt)

---

## 常见问题及解决方案

### “该文件不是有效的 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 并提供详细信息。