← 返回在线工具箱

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)看运行日志。

冀ICP备2022026296号-3冀公网安备13082502000105号© 2026 Biu腐蚀网