向导和启动问题
上次更新日期：2026/10/14端口已被占用
可能的原因
QV2QS 的另一个实例或另一个应用程序正在使用相同的网络端口。控制台显示ERROR: Port [number] is already in use.
建议的操作
关闭其他应用程序，或使用--port指定不同的端口。使用 --port 0 允许系统自动选择一个可用端口。
向导在 Internet Explorer 中打开或未正确呈现
可能的原因
Internet Explorer 是此计算机上的默认浏览器。QV2QS 用户界面需要现代浏览器，且无法在 Internet Explorer 中运行。
建议的操作
安装 Google Chrome、Microsoft Edge 或 Mozilla Firefox。QV2QS 在启动时检测默认浏览器，并在可用时自动打开受支持的浏览器。如果未找到支持的浏览器，控制台会显示下载链接。
在 Windows Server 2019 上，Internet Explorer 是唯一默认安装的浏览器。在以向导模式运行 QV2QS 之前，请安装一个受支持的浏览器。或者，使用命令行界面，无需浏览器。请参阅参数参考以获取 CLI 参数的完整列表。
转换失败或在向导中产生意外结果
可能的原因
向导显示一个摘要错误，但没有公开识别根本原因所需的完整诊断详细信息。
建议的操作
从命令行重新运行相同的转换，并启用调试日志。执行以下操作：
- 在向导中，导航到审查步骤。
- 单击复制命令以将完整的 CLI 命令复制到剪贴板。
- 打开一个终端窗口并粘贴复制的命令。
- 将
--logLevel DEBUG追加到命令的末尾，然后按 Enter 键。
控制台显示详细输出，涵盖每次转换决策、云 API 调用以及对象处理步骤。完整的调试日志也会写入到输出目录中的logs/子文件夹。
复制的命令包含在向导中配置的所有设置。附加 --logLevel DEBUG 是启用完整诊断所需的唯一更改。
请参阅日志记录和诊断以了解日志文件格式和位置。
QV2QS 已停止
模态窗口在浏览器中弹出
可能的原因
QV2QS 进程在向导仍在浏览器中打开时已关闭、崩溃或终止。用户界面通过周期性健康检查监控后端服务，并在服务变得不可达时显示模态框。
建议的操作
执行以下选项之一：
- 重新连接到当前会话。复制模态框中显示的命令，并在终端中运行该命令。该命令包括
--port和--noBrowser以重新连接到同一端口上的同一浏览器选项卡。服务器启动后，点击弹窗中的重新连接。向导恢复，所有之前输入的设置保持不变。 - 关闭浏览器标签页。点击 关闭窗口 在模态框中。当前向导会话中任何未保存的设置都将丢失。
示例项目文件缺失或已损坏
可能的原因
示例 QVW 文件在 %TEMP%\QV2QS\examples\ 已被删除、移动或在 QV2QS 外部修改。
建议的操作
从 %TEMP%\QV2QS\examples\ 删除受影响的文件，并重新启动 QV2QS。启动时会自动提取一份新的副本。为了保留示例文件的永久副本，请在修改前将文件复制到本地工作文件夹。请参阅示例项目。