常见报错速查表

按"看到什么报错 → 什么原因 → 怎么解决"整理。用浏览器 Ctrl+F 搜关键词最快。

服务器启动类

FXServer 启动闪退 / 提示缺少 DLL

• 原因：没有安装 VC++ 运行库，或程序路径包含中文
• 解决：安装 Visual C++ Redistributable；把服务器移到纯英文路径如 D:\fivem-server

Couldn't load resource legal error / fxmanifest 报错

• 原因：资源缺少 fxmanifest.lua 或 fx_version 写错
• 解决：检查资源目录结构，参考示例资源模板的正确写法

creating a new keymint 后卡住不动

• 原因：服务器连不上 cfx.re 验证服务
• 解决：网络问题，配置代理或使用稳定的境外网络出口；国内部分时段会有波动

数据库类

ER_ACCESS_DENIED_ERROR / 1045 Access denied

• 原因：数据库账号或密码错误
• 解决：用 phpMyAdmin 试登录验证账号密码；检查连接字符串里的特殊字符（@ # 需要转义）

ECONNREFUSED 127.0.0.1:3306

• 原因：MySQL 没启动，或端口不是 3306
• 解决：先在面板里确认 MySQL 处于运行状态，详见数据库安装教程

端口与连接类

Address already in use（30120 端口被占用）

• 原因：已经有一个 FXServer 在跑（可能 txAdmin 里开过）
• 解决：任务管理器结束多余的 FXServer.exe 进程，再启动

自己能进，朋友进不来

• 原因：端口映射没做，或防火墙拦截
• 解决：
  1. 服务器防火墙放行 30120 的 UDP 和 TCP
  2. 家用网络需要在路由器上把 30120 转发到服务器内网 IP
  3. 运营商没有公网 IP 的话，改用云服务器或内网穿透工具

服务器列表搜不到自己的服

• 原因：新服务器需要通过 Cfx.re 审核（通常几小时内）；列表还要求服务器满足一定在线时长
• 解决：审核期间玩家用 connect IP:30120 直连即可

资源下载类

txAdmin 配方卡在下载 / 报 403 ETIMEDOUT

• 原因：配方资源全部托管在 GitHub，国内直连不通，这是国内开服第一大痛点
• 解决：
  1. 挂全局代理后重新跑配方
  2. 或改用本站资源库手动搭建
  3. 关注本站公告，国内直连配方源正在路上

资源加载了但游戏里没反应

• 原因：资源没写进 server.cfg 的 ensure 列表，或依赖的资源没装
• 解决：确认 ensure 资源名 与文件夹名完全一致（区分大小写）；查看控制台红色报错定位缺失依赖