Skip to content

[Bug] ZCode 3.5.3 在无 GPU 的 Windows 服务器上渲染进程启动崩溃 (exit code 18) #196

Description

@isenlink

提交前确认 · Pre-submission checklist

  • 我已搜索过现有 issue,确认这不是重复 / I searched existing issues and confirmed this isn't a duplicate.
  • 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.

问题类别 · Category

UI / 界面体验 · UI / UX

涉及的 Agent 框架 · Agent framework

ZCode Agent(自研)

严重程度 · Severity

阻塞使用 · Blocking (无法使用核心功能 / core function unusable)

复现频率 · Reproducibility

必现 · Always

问题描述 · Description

问题描述

ZCode 桌面端从 3.4.x 自动升级到 3.5.3 后,在无独立显卡的 Windows 服务器上无法启动,渲染进程启动即崩溃,程序随后退出。每次自动升级后都会复现此问题。

环境

  • OS: Windows Server (无独立显卡 / 无 GPU)
  • ZCode 版本: 3.5.3(从 3.4.0 / 3.4.1 自动升级而来)
  • 安装路径: D:\Program Files\ZCode
  • 配置: desktopChromiumHardwareAccelerationEnabled = true

复现步骤

  1. 在无 GPU 的 Windows 服务器上安装 ZCode 3.5.3
  2. 启动 ZCode
  3. 程序启动后窗口无法显示,渲染进程立即崩溃退出

日志关键错误(每次启动必现)

复现步骤 · Steps to reproduce

exit code 18 + launch-failed 出现在渲染进程,结合无 GPU 环境,高度怀疑是 Chromium GPU 进程初始化失败导致渲染进程无法启动。

已尝试的临时解决方案

  1. ❌ 关闭硬件加速(修改 setting.json 中 desktopChromiumHardwareAccelerationEnabled = false)—— 无效
  2. ❌ 启动参数 --disable-gpu --disable-software-rasterizer --in-process-gpu —— 无效
  3. 启动参数 --disable-gpu --disable-gpu-compositing --disable-software-rasterizer --no-sandbox —— 可正常启动

禁用 GPU 合成 + 沙箱后才能启动,说明问题与 Chromium GPU 合成 / 沙箱在无 GPU 环境下的初始化有关。

期望表现 · Expected behavior

在无 GPU 的服务器环境下,ZCode 应自动检测并回退到纯软件渲染,而不是渲染进程崩溃导致无法启动。建议:

  1. 检测到无 GPU / 服务器环境时,自动启用软件渲染回退
  2. 或在 desktopChromiumHardwareAccelerationEnabled = false 时,连带禁用 GPU 合成和沙箱(目前单独设为 false 不生效)

实际表现 · Actual behavior

所有在无显卡 Windows 服务器上部署 ZCode 的用户,升级到 3.5.3 后将完全无法使用。

ZCode 版本 · ZCode version

3.5.3

设备 / 系统 / 浏览器 · Device / OS / Browser

windows server 2019

截图 / 录屏 / 日志 · Screenshots / Recordings / Logs

2026-07-28.log

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions