InvokeAI Installer 故障排查☍

故障排查☍

运行脚本时出现中文乱码☍

这可能是 Windows 系统中启用了 UTF 8 编码，可以按照下列方法解决。

1. 按下 Win + R 键，输入 control 后回车启动控制面板。
2. 点击 时钟和区域->区域
3. 在弹出的区域设置窗口中点击顶部的 管理，再点击 更改系统区域设置.
4. 在弹出的窗口中将 使用 Unicode UTF-8 提供全球语言支持 取消勾选，然后一直点击确定保存设置，并重启电脑。

无法使用 PowerShell 运行☍

运行 PowerShell 脚本时出现以下错误。

.\invokeai_installer.ps1 : 无法加载文件 D:\InvokeAI\invokeai_installer.ps1。
未对文件 D:\InvokeAI\invokeai_installer.ps1 进行数字签名。无法在当前系统上运行该脚本。
有关运行脚本和设置执行策略的详细信息，请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。
所在位置 行:1 字符：1
+ .\invokeai_installer.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : SecurityError: (:) []，PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

或者右键运行 PowerShell 脚本时闪一下 PowerShell 的界面后就消失了。

这是因为未解除 Windows 系统对运行 PowerShell 脚本的限制，请使用管理员权限打开 PowerShell，运行下面的命令。

Set-ExecutionPolicy Unrestricted -Scope CurrentUser

或者使用 环境配置 中的脚本解除 Windows 系统对运行 PowerShell 脚本的限制。

启用 Windows 长路径支持☍

使用管理员权限打开 PowerShell，运行以下命令：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

ERROR: THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE☍

运行 InvokeAI Installer 时出现以下类似的错误。

ERROR: THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE. If you have updated the package versions, please update the hashes. Otherwise, examine the package contents carefully; someone may have tampered with them.
    rsa<5,>=3.1.4 from https://mirrors.cloud.tencent.com/pypi/packages/49/97/fa78e3d2f65c02c8e1268b9aba606569fe97f6c8f7c2d74394553347c145/rsa-4.9-py3-none-any.whl#sha256=90260d9058e514786967344d0ef75fa8727eed8a7d2e43ce9f4bcf1b536174f7 (from google-auth<3,>=1.6.3->tensorboard==2.10.1->-r requirements.txt (line 12)):
        Expected sha256 90260d9058e514786967344d0ef75fa8727eed8a7d2e43ce9f4bcf1b536174f7
             Got        b7593b59699588c6ce7347aecf17263295c079efb3677553c2a81b08e857f838

这是因为下载下来的 Python 软件包出现了损坏，Pip 无法进行安装，需要将 InvokeAI/cache/pip 文件夹删除，再重新运行 InvokeAI Installer。

运行 InvokeAI 时 InvokeAI 出现崩溃☍

尝试增加 Windows 系统虚拟内存。

Microsoft Visual C++ Redistributable is not installed, this may lead to the DLL load failure.☍

下载 Microsoft Visual C++ Redistributable 并安装。

NotFoundError: 无法在"Node"上执行"removeChild": 要删除的节点不是此节点的子节点☍

尝试重置 UI 或者更换浏览器。

AttributeError: 'LayerNorm' object has no attribute 'get_num_patches'☍

InvokeAI 5.6.0 和之后的版本暂时无法使用带有 Norm 块的 LyCORIS 模型，可尝试使用 remove_lycoris_norm_block.py 脚本移除 LyCORIS 模型中的 Norm 块解决。

运行 terminal.ps1 打开终端，输入下面的命令下载 remove_lycoris_norm_block.py。

Invoke-WebRequest -Uri https://raw.githubusercontent.com/licyk/hub-action/refs/heads/main/tools/remove_lycoris_norm_block.py -OutFile remove_lycoris_norm_block.py

下载该脚本成功后，找到 LyCORIS 模型的路径，比如D:/Downloads/BaiduNetdiskDownload/ill-xl-01-rurudo_3-000034.safetensors，然后运行该脚本并传入该模型路径。

python remove_lycoris_norm_block.py "D:/Downloads/BaiduNetdiskDownload/ill-xl-01-rurudo_3-000034.safetensors"

得到移除 Norm 块的 LyCORIS 模型后即可导入到 InvokeAI 中使用。

InvokeAI 模型管理器中部分模型无法下载☍

在 InvokeAI 的模型管理器中，部分模型在 HuggingFace 上被设置的权限，下载时需要 HuggingFace 令牌才能下载。可在 InvokeAI 模型管理器 -> 添加模型 -> HuggingFace 令牌选项获取并添加 HuggingFace 令牌。

PowerShell 中出现 xFormers 报错☍

在控制台中出现有关 xFormers 的警告信息，类似下面的内容。

WARNING[XFORMERS]: xFormers can't load C++/CUDA extensions. xFormers was built for:
    PyTorch 2.2.1+cu118 with CUDA 1108 (you have 2.2.2+cu121)
    Python  3.10.11 (you have 3.10.11)
  Please reinstall xformers (see https://github.com/facebookresearch/xformers#installing-xformers)
  Memory-efficient attention, SwiGLU, sparse and more won't be available.

这是因为 xFormers 所适配的 CUDA 版本和 PyTorch 所带的 CUDA 版本不一致，请运行 reinstall_pytorch.ps1 脚本进行修复。

重装 PyTorch / xFormers☍

运行 reinstall_pytorch.ps1 脚本。

InvokeAI 无法正常调用显卡☍

尝试将显卡驱动更至最新或者运行 reinstall_pytorch.ps1 脚本重装 PyTorch。