# 故障排除

诊断和解决在转换和部署过程中遇到的常见问题。每个问题都遵循可能原因 / 建议措施 模式。

* [向导和启动问题](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/troubleshooting/wizard-and-startup-issues.htm) — 解决 UI 组件故障和端口冲突。
* [QlikView Desktop 问题](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/troubleshooting/qlikview-desktop-issues.htm) — 解决 QlikView 实例冲突和 PRJ 生成超时问题。
* [Qlik Cloud 连接问题](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/troubleshooting/qlik-cloud-connection-issues.htm) — 解决身份验证失败、API 密钥问题、角色配置错误和上下文冲突。
* [构建和部署问题](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/troubleshooting/build-and-deployment-issues.htm) — 解决云构建错误和媒体上传失败。
* [转换输出问题](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/troubleshooting/conversion-output-issues.htm) — 解决占位符对象、批处理失败、意外的维度或度量以及字体差异。

## 首先检查哪个日志

QV2QS 写入两个独立的日志。位于 `%LOCALAPPDATA%\QV2QS\qv2qs.log` 的系统日志始终会写入，从进程启动的那一刻起。输出目录中的单次运行日志仅在命令行参数解析完毕且输出文件夹初始化完成后创建。

* 如果进程在生成输出前崩溃或退出，请检查系统日志。每次运行的日志尚不存在。
* 如果转换运行但产生了意外结果，请检查输出目录的`logs/`子文件夹中的每次运行日志。
* 如果 批处理运行显示失败文件但没有错误详细信息，请检查系统日志中是否存在批处理级别错误，例如缺少 QlikView Desktop 或先决条件失败。

有关日志位置、格式以及两种日志之间重叠的完整指南，请参阅[日志记录和诊断](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm)。

## 启用诊断日志记录

运行转换，并使用 `--logLevel DEBUG` 记录转换决策、云 API 调用、引擎发现步骤以及对象处理详细信息。调试级别条目会同时出现在系统日志和单次运行日志（可用时）中。

## 了解更多

* [日志记录和诊断](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm)
* [开始](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/index.htm)
* [部署到 Qlik Cloud](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)
* [已知限制](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/known-limitations/index.htm)