AegisSpeed 错误代码手册

快速检查

使用 Ctrl+F 快速搜索错误码
错误码前缀表示所属模块和等级

错误代码概览

本手册包含 AegisSpeed 项目中所有预定义的错误代码及其详细说明，帮助开发者快速定位和解决问题。

错误码结构

错误码采用五位数字编码，前两位表示错误等级和模块：

前缀	模块	说明
`00xxx`	主异常	核心系统错误
`10xxx`	数据异常	数据处理相关错误
`20xxx`	配置异常	配置文件相关错误
`30xxx`	UI异常	用户界面相关错误
`40xxx`	检查单元异常	系统检查单元错误
`50xxx`	请求异常	网络请求相关错误
`60xxx`	线程异常	多线程相关错误
`70xxx`	系统监控异常	系统监控相关错误
`80xxx`	核心异常	核心功能错误

错误等级说明

等级	图标	影响	处理建议
🔴	`FATAL`	系统无法继续运行	立即终止程序
🟠	`ERROR`	功能完全失效	记录日志并报警
🟡	`WARNING`	部分功能受影响	记录日志并提示用户
🟢	`INFO`	不影响运行	仅记录日志

AegisSpeed 错误代码描述

提示

本章节详细列出了 AegisSpeed 项目中所有异常类型的错误代码，按照模块分类组织，便于快速查找和定位问题。

MainException

主系统异常，表示核心系统级别的错误。

错误码	类型	等级	说明
`-00000`	AegisSpeedMainException	🔴	找不到vdi完整性校验表 (unable to find VDI_TABLE)

DataException

数据处理异常，涉及数据读写、转换和展示等问题。

错误码	类型	等级	说明
`-10000`	AegisSpeedDataException	🟠	无法向 tree widget 更新 json_data (unable to update json_data to tree widget)
`-10001`	AegisSpeedDataException	🟡	无法生成条形码 (unable to generate bar code)
`-10002`	AegisSpeedDataException	🔴	基础数据文件丢失 (base data file not found)

SettingException

配置文件异常，涵盖配置文件的读写、更新、保存等操作。

错误码	类型	等级	说明
`-20000`	AegisSpeedSettingException	🔴	无法初始化配置文件 (unable to initialize settings)
`-20001`	AegisSpeedSettingException	🟠	读取配置文件时发生错误 (error occurred while loading config file)
`-20002`	AegisSpeedSettingException	🟡	无法更新配置文件 (unable to update settings)
`-20003`	AegisSpeedSettingException	🟡	保存配置文件时发生错误 (error occurred while saving config file)
`-20004`	AegisSpeedSettingException	🟠	找不到配置文件 (config file not found)
`-20005`	AegisSpeedSettingException	🟠	找不到数据文件 (data file not found)
`-20006`	AegisSpeedSettingException	🟠	找不到加密数据文件 (encrypted data file not found)
`-20007`	AegisSpeedSettingException	🟠	读取内核数据文件时发生错误 (error occurred while loading core data file)
`-20008`	AegisSpeedSettingException	🟡	读取设置数据文件时发生错误 (error occurred while loading config data file)
`-20009`	AegisSpeedSettingException	🟡	读取检查单元数据文件时发生错误 (error occurred while loading check units data file)
`-20010`	AegisSpeedSettingException	🟡	读取监控系统数据文件时发生错误 (error occurred while loading monitor system data file)
`-20011`	AegisSpeedSettingException	🟡	保存用户存档文件时发生错误 (error occurred while saving profile file)

UIException

用户界面异常，涉及静态资源渲染、加载和更新等问题。

错误码	类型	等级	说明
`-30000`	AegisSpeedUIException	🟠	静态资源渲染失败 (unable to render static resource)
`-30001`	AegisSpeedUIException	🟡	静态资源丢失 (static resource not found)
`-30002`	AegisSpeedUIException	🟡	静态资源更新失败 (unable to update static resource)
`-30003`	AegisSpeedUIException	🟠	加载窗口属性失败 (unable to pre-load windows QApplication Attributes)
`-30004`	AegisSpeedUIException	🟠	加载应用环境变量失败 (unable to pre-load windows QApplication Environments)

CheckUnitException

检查单元异常，涵盖系统自检、硬件信息获取等功能。

错误码	类型	等级	说明
`-49999`	AegisSpeedCheckUnitException	🔴	ASAC权限不足 (insufficient ASAC permissions)
`-40000`	AegisSpeedCheckUnitException	🟠	SIP自检时发生错误 (error occurred while SIP)
`-40001`	AegisSpeedCheckUnitException	🟡	SIP检查 windows 版本信息时发生错误 (error occurred while SIP checking windows platform)
`-40002`	AegisSpeedCheckUnitException	🟡	SIP检查 windows wmic 信息时发生错误 (error occurred while SIP checking windows wmic)
`-40003`	AegisSpeedCheckUnitException	🟡	SIP检查 windows defender 信息时发生错误 (error occurred while SIP checking windows defender)
`-40004`	AegisSpeedCheckUnitException	🟡	SIP检查 windows MACE 信息时发生错误 (error occurred while SIP getting MACE)
`-40005`	AegisSpeedCheckUnitException	🟡	SIP检查 windows network info 信息时发生错误 (error occurred while SIP getting network info)
`-40006`	AegisSpeedCheckUnitException	🟡	公网ip地址获取失败 (unable to get WAN ip address)
`-40007`	AegisSpeedCheckUnitException	🟡	局域网ip地址获取失败 (unable to get LAN ip address)
`-40008`	AegisSpeedCheckUnitException	🟡	ip地址定位获取失败 (unable to get LAN ip location)
`-40009`	AegisSpeedCheckUnitException	🟡	接口返回了空的地址 (empty location returned)
`-40010`	AegisSpeedCheckUnitException	🟡	SIP获取本机网络信息时发生错误 (error occurred while getting network information)
`-40011`	AegisSpeedCheckUnitException	🟡	获取本机虚拟化信息是发生错误 (error occurred while getting virtualization information)
`-40012`	AegisSpeedCheckUnitException	🟠	读取内核数据文件时发生错误 (error occurred while getting local core data)
`-40013`	AegisSpeedCheckUnitException	🟡	读取系统USB设备信息时发生错误 (error occurred while getting system usb devices info)
`-40014`	AegisSpeedCheckUnitException	🟡	读取系统活动信息时发生错误 (error occurred while getting system avtivity info)
`-40015`	AegisSpeedCheckUnitException	🟡	读取系统PCIe高速串行总线设备信息时发生错误 (error occurred while getting system PCIe devices info)
`-40016`	AegisSpeedCheckUnitException	🟡	读取系统ACPI高级配置和电源管理接口设备信息时发生错误 (error occurred while getting system ACPI devices info)
`-40017`	AegisSpeedCheckUnitException	🟡	读取系统BTH蓝牙设备信息时发生错误 (error occurred while getting system BTH devices info)
`-40018`	AegisSpeedCheckUnitException	🟡	读取系统HID人机交互设备信息时发生错误 (error occurred while getting system HID devices info)
`-40019`	AegisSpeedCheckUnitException	🟡	读取系统开关机记录时发生错误 (error occurred while getting system turn on/off logs)
`-40020`	AegisSpeedCheckUnitException	🟡	读取系统DLL文件注册信息时发生错误 (error occurred while getting system DLL registry)
`-40021`	AegisSpeedCheckUnitException	🟡	读取系统驱动程序注册信息时发生错误 (error occurred while getting system drivers info)
`-40022`	AegisSpeedCheckUnitException	🟡	读取系统崩溃信息时发生错误 (error occurred while getting system crash info)
`-40023`	AegisSpeedCheckUnitException	🟢	无法获取 AegisSpeed 服务器状态 (unable to check AegisSpeed server connection status)
`-40024`	AegisSpeedCheckUnitException	🟢	获取 AegisSpeed 服务器状态时发生错误 (error occurred while getting AegisSpeed server connection status)
`-40025`	AegisSpeedCheckUnitException	🟡	无法登录 AegisSpeed 服务器 (unable to login AegisSpeed server)
`-40026`	AegisSpeedCheckUnitException	🟠	无法校验 AegisSpeed 客户端版本号 (unable to verify AegisSpeed client version)
`-40026`	AegisSpeedCheckUnitException	🟠	无法注册 AegisSpeed 服务器 (unable to register AegisSpeed server)

RequestException

网络请求异常，处理不同模式下的数据请求错误。

错误码	类型	等级	说明
`-50000`	AegisSpeedRequestException	🟠	以JSON模式请求数据时发生错误 (error occurred while requesting json mode)
`-50001`	AegisSpeedRequestException	🟠	以DEFAULT模式请求数据时发生错误 (error occurred while requesting default mode)
`-50002`	AegisSpeedRequestException	🟠	客户端发生未知错误 (client error)
`-50003`	AegisSpeedRequestException	🟠	以CUSTOM模式请求数据时发生错误 (error occurred while requesting custom mode)

ThreadException

线程异常，涉及线程运行和调度过程中的错误。

错误码	类型	等级	说明
`-60000`	AegisSpeedThreadException	🟠	线程运行时发生错误 (error occurred while running thread)
`-60001`	AegisSpeedThreadException	🟠	调度线程时发生错误 (error occurred while dispatching thread)

SystemMonitorException

系统监控异常，涵盖进程、USB设备、资源等监控功能。

错误码	类型	等级	说明
`-70000`	AegisSpeedSystemMonitorException	🟠	启用 mgr 时发生错误 (error occurred while enabling mgr)
`-70001`	AegisSpeedSystemMonitorException	🟠	禁用 mgr 时发生错误 (error occurred while disabling mgr)
`-70002`	AegisSpeedSystemMonitorException	🔴	启用 AegisSpeed Protection 时发生错误 (error occurred while enabling AegisSpeed Protection)
`-70003`	AegisSpeedSystemMonitorException	🔴	禁用 AegisSpeed Protection 时发生错误 (error occurred while disabling AegisSpeed Protection)
`-70004`	AegisSpeedSystemMonitorException	🔴	SPEC模式发现系统进程池中存在黑名单进程 (blacklisted process found in system processes pool by AegisSpeed SPEC_MODE)
`-70005`	AegisSpeedSystemMonitorException	🟠	NOR模式发现系统进程池中存在黑名单进程 (blacklisted process found in system processes pool by AegisSpeed NOR_MODE)
`-70006`	AegisSpeedSystemMonitorException	🟡	在运行进程匹配器时发生错误 (error occurred while running processes matcher)
`-70007`	AegisSpeedSystemMonitorException	🟠	启动系统进程监控时发生错误 (error occurred while enabling processes monitor)
`-70008`	AegisSpeedSystemMonitorException	🟠	启动系统usb端口监控时发生错误 (error occurred while enabling USB devices monitor)
`-70009`	AegisSpeedSystemMonitorException	🟡	系统usb端口监控发现设备拔出事件 (system USB port monitoring detected a device removal event)
`-70010`	AegisSpeedSystemMonitorException	🟡	系统usb端口监控发现设备插入事件 (system USB port monitoring detected a device insertion event)
`-70011`	AegisSpeedSystemMonitorException	🟡	启动系统资源监控时发生错误 (error occurred while enabling Resource monitor)

CoreException

核心功能异常，涉及系统核心功能的错误。

错误码	类型	等级	说明
`-80000`	AegisSpeedCoreException	🟡	截屏时发生错误 (error occurred while taking screenshot)
`-80001`	AegisSpeedCoreException	🟡	压缩截屏文件时发生错误 (error occurred while compressing screenshot)