NC65 (UClient) 白屏、假死与日志爆盘根因复盘及双场景防御

一、 故障现象与触发场景

在日常运维用友 NC65 (UClient 客户端) 时，经常会遇到以下令终端用户和运维极度头疼的偶发故障：

• 实体物理机场景：办公电脑在按下 Win + L 锁屏、显示器息屏节能、合盖休眠唤醒、插拔外接高分屏（DPI 缩放切换）、或笔记本在核显与独立显卡（如 RTX 4060）之间动态切换时，NC65 界面突然变为不可逆的纯白屏，按快捷键也无法恢复。
• 远程虚拟机场景：用户通过 Windows 远程桌面 (RDP) 连入 NAS/KVM 或云端虚拟机办公，断开 RDP 会话后过段时间重新连入，UClient 必定出现白屏无响应或全黑屏假死。更严重的是伴随 CPU 空转，后台疯狂写入数十 GB 错误日志，单夜直接将系统 C 盘写满至 0 字节。

二、 深层根因链条（三重缺陷叠加）

通过对卡死现场抓取线程 Dump (jstack) 和系统调用分析，确认该问题并非单一故障，而是由于底层图形驱动、NC 框架日志流与 Swing 字体监听器的三重连锁缺陷共同触发：

第一层：Direct3D 设备丢失（导致白屏初始态）

Windows 在锁屏、息屏睡眠或断开 RDP 会话时，系统显示驱动（WDDM/IddCx 虚拟驱动）会重置或销毁 Direct3D 上下文。而 Java 2D 默认开启了 D3D/DirectDraw 硬件渲染加速。图形流水线破损后触发 D3DERR_DEVICELOST，由于 Java 离线无法恢复 Surface 缓冲区，Swing 画布重绘彻底失效，直接呈现不可逆的空白底色（白屏）。

第二层：NC 控制台流劫持阻塞 EDT（导致界面假死）

NC65 内部实现了 NCConsoleOutputStream，默认将 JVM 的 System.out 和 System.err 重定向到一个挂在 Swing 事件调度线程 (EDT) 上的文档模型中。一旦底层因渲染异常狂刷警告，该流在 EDT 线程上反复加锁处理，导致事件分发线程发生严重锁竞争并陷入停滞，窗口彻底失去鼠标与键盘响应。

第三层：字体提示刷新触发 NPE 死循环（终极灾难：磁盘爆满）

当用户重新接入 RDP、或者物理机外接扩展显示器导致 DPI 发生变动时，Windows 会向全局广播 WM_SETTINGCHANGE 消息。JDK 监听到桌面字体平滑（awt.font.desktophints）变化后，Swing 的 MetalLookAndFeel$AATextListener 会递归调用 SwingUtilities.updateComponentTreeUI() 强制重构整棵 UI 树。

此时 NC65 的动作栏布局管理器 BasicActionsBarUI$ActionsBarLayoutManager.computerBtnsHeight 存在代码缺陷（未对父级容器做非空保护），突发重构时必定抛出 NullPointerException (NPE)。而该 NPE 中断了布局并再次触发重绘，进而陷入每秒数万次的死循环抛错。在某次真实故障中，单夜写入日志达到 38 GB，直接耗尽 C 盘可用空间。

三、 核心防御 JVM 参数栈

该方案无需反编译修改任何 NC 代码或补丁包，只需通过 JVM 启动参数对图形渲染、日志重定向及字体事件进行底层静态固化：

-Dsun.java2d.d3d=false -Dsun.java2d.noddraw=true -Dredirect=N -Dawt.useSystemAAFontSettings=lcd

四、 双场景加固落地与直接发给 AI 的执行话术

如果目标机器上安装了 AI 编程助手（如 Antigravity、Cursor、Windsurf、Copilot 等），建议直接复制对应场景的话术丢给 AI，让 AI 按先备份后修改的严格规范自主执行加固。

4.1 方案一：实体物理机场景（笔记本 / 台式机）

实体机通常配备独立显卡与核显，并可能安装有向日葵 (OrayIddDriver) 或 ToDesk 等远程虚拟显示驱动。关注锁屏、睡眠与高分屏插拔。

📋 直接发给【实体机】AI 助手的话术（复制即用）：

# 任务：为本机用友 NC65 (UClient) 实体机环境注入白屏与假死防御配置

### 一、 背景与本地真机根因说明
在实体物理机（笔记本/台式机）运行用友 NC65 (UClient 客户端) 时，在遇到 Windows 锁屏 (Win+L)、系统息屏/休眠唤醒、插拔外接扩展显示器 (DPI变化)、以及独显/核显动态切换时，极易触发以下连锁故障：
1. Direct3D 设备丢失导致 Swing 界面永久白屏；
2. NC 控制台劫持标准输出阻塞 EDT 事件调度线程导致假死；
3. 字体提示刷新消息触发 NC 动作栏组件 NPE 死循环并刷爆磁盘。

针对上述问题的实体机无侵入全局防御栈参数为：
-Dsun.java2d.d3d=false -Dsun.java2d.noddraw=true -Dredirect=N -Dawt.useSystemAAFontSettings=lcd

---

### 二、 请帮我完成以下排查与自动化加固工作（遵守先备份后修改原则，严禁静默删除任何文件）

#### 步骤 1：排查当前环境与 UClient 现状
1. 检查是否存在正在运行的 UClient.exe 或 javaw.exe 进程（若有，提示我先关闭）。
2. 定位本机 UClient 应用配置目录（默认位于 %LOCALAPPDATA%\UClient\apps）。
3. 扫描该目录下所有应用，区分 Java/NC 业务应用与微浏览器（跳过 ubrowser 等非 Java 应用），读取并输出每个 NC 应用当前的 JVM 参数。

#### 步骤 2：全量双重安全备份
在修改任何文件前，必须完成备份：
1. 创建集中归档备份目录：%LOCALAPPDATA%\UClient\_backup_<当前时间戳>，将所有 NC 应用的 client.esc 和 app.esc 复制备份。
2. 在每个应用目录下，同步生成一份带时间戳的同级备份文件（如 client.esc.bak_<时间戳> 和 app.esc.bak_<时间戳>）。

#### 步骤 3：幂等安全注入防御参数
对每个 NC 应用的 client.esc 和 app.esc 进行配置更新：
1. 注入目标：确保 <args jvm="..."/> 中完整包含以下 4 项参数：
   -Dsun.java2d.d3d=false -Dsun.java2d.noddraw=true -Dredirect=N -Dawt.useSystemAAFontSettings=lcd
2. 幂等性要求：若已有某项参数，不要重复追加；缺失的参数规范追加到 jvm 属性末尾。
3. 编码与格式保护：
   - client.esc 通常为 UTF-8 with BOM，app.esc 通常为 UTF-8 without BOM，写回时必须保持原文件的 BOM 编码特性。
   - 保持原有 XML 标签排版、缩进和属性完整，严禁破坏节点结构。

#### 步骤 4：校验与结果汇报
1. 重新解析修改后的 XML 文件，校验语法是否合法，并确认 4 项参数均已正确存在。
2. 输出排查与注入结果表格（包含：业务系统名、目录 ID、注入前后状态）。

💻 实体机 PowerShell 一键脚本（运维无 AI 时备用）：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$timestamp = Get-Date -Format 'yyyyMMdd_HHmmss'
$baseDir = "$env:LOCALAPPDATA\UClient\apps"
$centralBackupDir = "$env:LOCALAPPDATA\UClient\_backup_$timestamp"
if (-not (Test-Path $baseDir)) { Write-Error "未找到 UClient 目录"; exit 1 }
New-Item -ItemType Directory -Path $centralBackupDir -Force | Out-Null

$defenseArgs = @('-Dsun.java2d.d3d=false', '-Dsun.java2d.noddraw=true', '-Dredirect=N', '-Dawt.useSystemAAFontSettings=lcd')

function Update-JvmString($origJvm) {
    $current = $origJvm.Trim()
    foreach ($arg in $defenseArgs) {
        $key = $arg.Split('=')[0]
        if ($current -match [regex]::Escape($key) + '=[^\s"]*') {
            $current = [regex]::Replace($current, [regex]::Escape($key) + '=[^\s"]*', $arg)
        } else {
            $current = $current + ' ' + $arg
        }
    }
    return $current.Trim()
}

$results = @()
Get-ChildItem -Path $baseDir -Directory | Where-Object {
    (Test-Path (Join-Path $_.FullName "client.esc")) -and (Test-Path (Join-Path $_.FullName "app.esc"))
} | ForEach-Object {
    $clientEsc = Join-Path $_.FullName "client.esc"
    $appEsc = Join-Path $_.FullName "app.esc"
    try {
        [xml]$testXml = Get-Content $clientEsc -Encoding UTF8
        if ($null -eq $testXml.app.start.profile.java) { return }
        $appName = $testXml.app.name.'#text'
    } catch { return }

    $backupSubDir = Join-Path $centralBackupDir $_.Name
    New-Item -ItemType Directory -Path $backupSubDir -Force | Out-Null
    Copy-Item $clientEsc (Join-Path $backupSubDir "client.esc") -Force
    Copy-Item $appEsc (Join-Path $backupSubDir "app.esc") -Force
    Copy-Item $clientEsc (Join-Path $_.FullName "client.esc.bak_$timestamp") -Force
    Copy-Item $appEsc (Join-Path $_.FullName "app.esc.bak_$timestamp") -Force

    foreach ($file in @($clientEsc, $appEsc)) {
        $bytes = [System.IO.File]::ReadAllBytes($file)
        $hasBom = ($bytes.Length -ge 3 -and $bytes[0] -eq 0xEF -and $bytes[1] -eq 0xBB -and $bytes[2] -eq 0xBF)
        $encoding = [System.Text.UTF8Encoding]::new($hasBom)
        $content = [System.IO.File]::ReadAllText($file, [System.Text.Encoding]::UTF8)
        $newContent = [regex]::Replace($content, '(?<=jvm=")([^"]*)(?=")', { param($m) Update-JvmString $m.Value })
        [System.IO.File]::WriteAllText($file, $newContent, $encoding)
    }
    $results += [PSCustomObject]@{ '业务系统' = $appName; '目录' = $_.Name; '加固状态' = '成功注入4项' }
}
Write-Output "=== 备份目录: $centralBackupDir ==="
$results | Format-Table -AutoSize

---

4.2 方案二：远程虚拟机场景（RDP / KVM / 云桌面）

虚拟机因无显卡直通，RDP 断开时白屏率高达 100%。在虚拟机实施加固时需额外执行四项专属排查：

1. 首要急救：排查并清理 C 盘日志：先检查 C 盘可用空间，清理 %LOCALAPPDATA%\UClient\log\ 目录下数十 GB 的膨胀日志，避免磁盘空间为 0 导致配置文件写入空字节损坏。
2. 确认虚拟显卡类型：VirtIO-GPU、QXL 或 VMware SVGA 均缺乏硬件 Direct3D 支撑，必须关闭硬件加速。
3. 严格检查窗口模式（严禁改动）：确认 client.esc 中的 <openMode> 必须保持 embed（嵌入模式）。若误改为 disembed，在 RDP 虚拟环境下会导致窗口句柄丢失进而陷入黑屏死锁。
4. 规范会话退出机制：若需挂机跑批量凭证，建议使用 tscon %sessionname% /dest:console 脚本将会话切换到控制台退出，防止会话被 Windows 强制冻结。

📋 直接发给【远程虚拟机】AI 助手的话术（复制即用）：

# 任务：为本机远程虚拟机环境下的用友 NC65 (UClient) 执行白屏与爆盘防御加固

### 一、 背景说明
本机为虚拟机环境（无显卡直通），通过 RDP 远程桌面访问。RDP 会话断开重连时，虚拟图形 Surface 销毁导致 NC65 界面白屏，同时字体提示刷新会触发动作栏 NPE 死循环，单夜曾刷出数十 GB 日志将 C 盘写为 0 字节。
核心防御参数为：
-Dsun.java2d.d3d=false -Dsun.java2d.noddraw=true -Dredirect=N -Dawt.useSystemAAFontSettings=lcd

---

### 二、 请帮我完成以下排查与自动化加固工作（先清盘、再备份、后修改，严禁静默删除有效数据）

#### 步骤 1：磁盘与进程前置检查
1. 检查 C 盘可用空间；若空间不足 1GB，先排查并汇报 %LOCALAPPDATA%\UClient\log 目录下的超大日志文件，征得同意后清理释放空间；
2. 检查 UClient.exe / javaw.exe 进程，若正在运行提示我先退出客户端；

#### 步骤 2：架构模式检查与纠正
核查 client.esc 中的 <openMode> 是否为 embed。若被误改为 disembed 必须改回 embed（防止 RDP 下黑屏死循环）。

#### 步骤 3：全量双重安全备份
在修改任何文件前，必须完成备份：
1. 创建集中归档备份目录：%LOCALAPPDATA%\UClient\_backup_<当前时间戳>，将所有 NC 应用的 client.esc 和 app.esc 复制备份。
2. 在每个应用目录下，同步生成一份带时间戳的同级备份文件（如 client.esc.bak_<时间戳> 和 app.esc.bak_<时间戳>）。

#### 步骤 4：幂等注入防御参数
为 %LOCALAPPDATA%\UClient\apps 下所有 NC 应用的 client.esc 和 app.esc 注入上述 4 项 JVM 参数（保持原有 BOM 编码与 XML 缩进排版）。

#### 步骤 5：校验与结果汇报
重新解析修改后的 XML 文件，校验语法合法性，并输出排查与加固前后状态清单表格。

💻 虚拟机 PowerShell 一键加固与日志检查脚本（运维备用）：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$timestamp = Get-Date -Format 'yyyyMMdd_HHmmss'
$baseDir = "$env:LOCALAPPDATA\UClient\apps"
$logDir = "$env:LOCALAPPDATA\UClient\log"
$centralBackupDir = "$env:LOCALAPPDATA\UClient\_backup_$timestamp"

# 1. 检查 C 盘可用空间与日志
$cDrive = Get-PSDrive C
$freeGB = [math]::Round($cDrive.Free / 1GB, 2)
Write-Output "当前 C 盘可用空间: $freeGB GB"
if (Test-Path $logDir) {
    $logSize = [math]::Round(((Get-ChildItem $logDir -Recurse | Measure-Object -Property Length -Sum).Sum / 1MB), 2)
    Write-Output "UClient 日志目录占用: $logSize MB (路径: $logDir)"
}

if (-not (Test-Path $baseDir)) { Write-Error "未找到 UClient 目录"; exit 1 }
New-Item -ItemType Directory -Path $centralBackupDir -Force | Out-Null

$defenseArgs = @('-Dsun.java2d.d3d=false', '-Dsun.java2d.noddraw=true', '-Dredirect=N', '-Dawt.useSystemAAFontSettings=lcd')

function Update-JvmString($origJvm) {
    $current = $origJvm.Trim()
    foreach ($arg in $defenseArgs) {
        $key = $arg.Split('=')[0]
        if ($current -match [regex]::Escape($key) + '=[^\s"]*') {
            $current = [regex]::Replace($current, [regex]::Escape($key) + '=[^\s"]*', $arg)
        } else {
            $current = $current + ' ' + $arg
        }
    }
    return $current.Trim()
}

$results = @()
Get-ChildItem -Path $baseDir -Directory | Where-Object {
    (Test-Path (Join-Path $_.FullName "client.esc")) -and (Test-Path (Join-Path $_.FullName "app.esc"))
} | ForEach-Object {
    $clientEsc = Join-Path $_.FullName "client.esc"
    $appEsc = Join-Path $_.FullName "app.esc"
    try {
        [xml]$testXml = Get-Content $clientEsc -Encoding UTF8
        if ($null -eq $testXml.app.start.profile.java) { return }
        $appName = $testXml.app.name.'#text'
    } catch { return }

    # 检查 openMode 模式
    $openMode = $testXml.app.openMode
    $modeFixed = $false
    if ($openMode -ne "embed") {
        $testXml.app.openMode = "embed"
        $modeFixed = $true
    }

    $backupSubDir = Join-Path $centralBackupDir $_.Name
    New-Item -ItemType Directory -Path $backupSubDir -Force | Out-Null
    Copy-Item $clientEsc (Join-Path $backupSubDir "client.esc") -Force
    Copy-Item $appEsc (Join-Path $backupSubDir "app.esc") -Force
    Copy-Item $clientEsc (Join-Path $_.FullName "client.esc.bak_$timestamp") -Force
    Copy-Item $appEsc (Join-Path $_.FullName "app.esc.bak_$timestamp") -Force

    foreach ($file in @($clientEsc, $appEsc)) {
        $bytes = [System.IO.File]::ReadAllBytes($file)
        $hasBom = ($bytes.Length -ge 3 -and $bytes[0] -eq 0xEF -and $bytes[1] -eq 0xBB -and $bytes[2] -eq 0xBF)
        $encoding = [System.Text.UTF8Encoding]::new($hasBom)
        $content = [System.IO.File]::ReadAllText($file, [System.Text.Encoding]::UTF8)
        $newContent = [regex]::Replace($content, '(?<=jvm=")([^"]*)(?=")', { param($m) Update-JvmString $m.Value })
        if ($modeFixed -and ($file -eq $clientEsc)) {
            $newContent = [regex]::Replace($newContent, '(?<=)([^<]*)(?=)', 'embed')
        }
        [System.IO.File]::WriteAllText($file, $newContent, $encoding)
    }

    $results += [PSCustomObject]@{
        '业务系统' = $appName
        '目录' = $_.Name
        '加固状态' = '成功注入4项'
        'openMode' = if ($modeFixed) { "已纠正为 embed" } else { "正常 (embed)" }
    }
}
Write-Output "=== 备份目录: $centralBackupDir ==="
$results | Format-Table -AutoSize

五、 排查禁忌与沉淀总结

在排查此类客户端深度疑难时，有两条高频踩坑禁忌切勿复踩：

1. 切勿尝试修改 client.esc 独立窗口模式：试图改用 disembed 模式绕过嵌入式容器，会导致 NC 的 BasicSingleSideZoomPaneUI 陷入 revalidate() 递归黑屏循环。
2. 切勿反编译修改本地 NCCACHE 类库：NC65 的 ProvisionClassLoader 在启动时对本地所有 JAR 包计算安全哈希签名。私自修改字节码会直接触发 Client code is tampered 致命异常并拒绝启动。

理解 Windows 窗口消息机制、JVM 图形管线与 ERP 客户端容器的交互边界，是定位此类跨层复合故障的关键。通过规范的 JVM 参数栈与可复用的 AI 执行指令，可以在零侵入、零修改业务代码的前提下，让 NC65 在物理机与虚拟化办公场景中长期稳健运行。