4.6 KiB
4.6 KiB
title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags, restored_from_commit
| title | type | permalink | stable_id | scope | project_id | workspace_type | usage_profile_id | preference_context | document_type | revision | source_memory_ids | source_checkpoint_ids | source_file_ids | source_git_commit | source_git_commits | source_agent_sync_ids | model_connection | model_name | source_count | source_revisions | source_dispositions | cited_source_ids | job_cited_source_ids | conflicts | supersedes | preferences | source_cursor | source_hash | prompt_version | schema_version | curation_job_id | created_at | updated_at | tags | restored_from_commit | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| VMZhCN 常见故障及排查指南 | curated | main/projects/49564d35-91ae-430d-9d67-7bb8bec4c646/curated/development/vmzh-cn-常见故障及排查指南 | f68be77d-5786-49bb-8079-7dad971a5ae7 | project | 49564d35-91ae-430d-9d67-7bb8bec4c646 | development | null | development | troubleshooting | 1 | 3e0661c1216b285a039518ba6d810b8394657e1d |
|
Sub2API | git-restore | 24 |
|
196 | 0a84505c3e53c83a1d2f2e939a42b813a45b865e71febe7c7d488f60c0578b9b | 2026-08-12.3 | 3 | null | 2026-08-27T18:35:55.011353+00:00 | 2026-09-23T14:54:01.548947+00:00 |
|
6a6a895eaf |
错误与解决方案集合
| 场景 | 典型错误信息 | 可能原因 | 推荐处理步骤 |
|---|---|---|---|
| 文件缺失/锁定 | msg.cui.vmdberror.fileNotFound / msg.cui.vmdberror.vmlocked |
文件路径错误或被其他进程占用 | 检查路径、确保文件未被占用；必要时重启 VMware 服务（source: Batch 3/4 – Localization & UI Message Summary）。 |
| 权限不足 | msg.cui.vmdberror.noPermission / msg.cui.host.noPermission |
以非 root 用户执行需要管理员权限的操作 | 使用 sudo 重新运行命令；或在 Vaultwarden 中获取已保存的提升凭证（source: 105b328f-4bda-4641-90a7-7282ef156316）。 |
| VM 正在运行时修改磁盘 | msg.cui.vm.disk.shrink.independentNonpersistent |
试图在运行状态下压缩或改变磁盘模式 | 先 停止 虚拟机，再执行磁盘操作。 |
| 不受支持的硬件/控制器 | msg.cui.wizard.vm.busLogicVista |
选用了不兼容的 SCSI/IDE 控制器 | 在向导中提升硬件版本或更换为受支持的控制器。 |
| 加密冲突 | msg.cui.vmCryptoVMDB.decryptionFailedValidation |
存在快照、TPM、或链接克隆导致加密无法修改 | 删除相关快照或克隆，或先 导出 并重新导入为未加密的 VM。 |
| 网络配置错误 | msg.netcfg.NAT.PrefixV6BadFormat / msg.vmnetcfg.linux.cantRead |
IPv6 前缀格式错误或缺少根权限读取配置文件 | 使用正确的 IPv6 前缀格式；以 root 重新运行 vmware-netcfg 并检查 /etc/vmware/networking。 |
| 更新服务器不可达 | msg.cui.cdsResult.httpHostResolveError / msg.cui.cdsResult.proxyAuthenticationError |
DNS 问题或代理认证失败 | 检查网络连接、代理设置，必要时在 UI 中手动输入凭证。 |
| VMware Tools 未安装 | msg.cui.toolsInfoBar.txtNotInstalled |
客户系统未挂载或未运行 Tools 安装程序 | 在虚拟机内挂载 Tools ISO，手动运行 VMware-Tools-*.rpm 或对应的安装脚本。 |
| Easy‑Install 失效 | msg.cui.wizard.vm.easyinstall.fail.scanIso |
未提供有效的驱动 ISO 路径 | 在向导中手动指定驱动位置或改为手动安装。 |
| VNC 端口冲突 | msg.vnc.portChanged |
已有用户连接到 VNC 服务器 | 断开当前连接后再修改端口，或重启 VMware 服务。 |
| 备份恢复错误 | msg.cui.vmBackendVMDB.overrideLock |
备份目录已被占用或权限不足 | 确认 /var/backups/vmzhcn 存在且可写，必要时手动清理冲突的子目录。 |
诊断工具
- 使用
vmzhcn.py status查看当前字典路径、已安装消息数以及用户 locale（source:git:vmzhcn.py）。 vmzhcn.py coverage能快速定位仍缺失的 Linux 键，输出为missing-linux-en.vmsg，供翻译人员补全（source:git:README.md）。vmzhcn.py scan重新抓取最新二进制中的英文键，以便在新版本发布后生成增量更新（source:git:README.md）。
参考来源
- 错误信息与对应解释均摘自 Batch 3/4 – Localization & UI Message Summary（source:
Batch 3/4 – Localization & UI Message Summary）。 - 工作流与命令实现细节来源于
vmzhcn.py（source:git:vmzhcn.py）以及单元测试文件tests/test_vmzhcn.py（source:git:tests/test_vmzhcn.py）。
标签: [故障排查], [错误码], [解决方案]