← 返回在线工具箱
Oxide 插件报错速查
常见报错的原因与解法对照(新增:MySQL 报错、无响应排查两条)
按报错关键词对照排查,按出现频率排序。点”复制”拿关键词去日志里搜。
| 报错关键词 | 常见原因 → 解法 |
|---|---|
| Failed to compile | C# 编译失败,多为插件版本与 Oxide 不匹配 → 更新 Oxide 到最新版,再更新插件;看 Compiler 输出的行号定位。 |
| NullReferenceException | 插件访问了空对象,多为配置缺字段 → 删除 oxide/config/插件.json 重新生成,或补齐字段。 |
| Plugin takes too long to load | 初始化超时 → 检查是否死循环请求接口/数据库;重载一次;仍超时联系插件作者。 |
| Plugin loaded but had errors | 加载阶段报错,看上一行具体异常 → 拿关键词去 uMod 插件页评论区搜。 |
| Failed to load plugin(权限/依赖) | 缺依赖插件(如 ImageLibrary)→ 先装依赖再装本插件,依赖清单看插件页 Required Dependencies。 |
| Kicked: EAC: Authentication timed out | EAC 验证超时,多为端口/防火墙 → 检查 28015-28016 UDP 放行、系统时间同步。 |
| Steam 验证失败 / Auth flow fail | 服务器无法连 Steam → 检查出网;确认 Facepunch.Steamworks 程序集加载正常(日志无 FileNotFoundException)。 |
| Icon not showing(图片不显示) | ImageLibrary 签名/图标下载失败 → 检查出网与缓存目录权限,重载 ImageLibrary。 |
| Database is locked / MySQL error | 数据库连接异常 → 检查插件配置里的数据库账号;确认 MySQL 在跑、3306 可达;插件重载。 |
| Cooldown / 无响应但无报错 | 多为插件逻辑分支 → 开 debug 模式(插件 config 里 debug:true)看运行日志。 |
