Xarr支付系统数据库修复工具安装与使用教程

本文将以 宝塔面板部署方式 为例，详细介绍 xarr-db-repair 的安装、启动与使用流程。

一、工具说明

xarr-db-repair 是一款数据库结构预检与修复工具，主要用于：

• 检测数据库结构是否完整
• 识别缺失表、缺失字段、缺失索引等问题
• 根据预设策略执行修复
• 辅助处理升级、迁移后的数据库兼容问题

工具提供 Web 管理界面，部署完成后，可直接通过浏览器访问并进行操作。

二、部署前准备

在安装 xarr-db-repair 前，请先准备以下内容：

1. 服务器环境

建议已安装宝塔面板，并具备 Go 项目运行环境。

2. 二进制文件

准备好程序主文件：

xarr-db-repair

3. 数据库连接信息

使用前请提前确认以下数据库信息：

• MySQL 地址
• MySQL 端口
• 数据库名称
• 数据库用户
• 数据库密码

4. 备份数据库

在执行任何修复操作前，务必先备份目标数据库。数据库修复属于高敏感操作，建议始终遵循“先备份，再修复”的原则。

三、上传程序文件

建议将程序文件上传到固定目录，例如：

/www/go_project/xarr-db-repair/

上传完成后，程序完整路径示例为：

/www/go_project/xarr-db-repair/xarr-db-repair

如果是通过 SSH 上传，建议执行一次权限设置：

chmod +x /www/go_project/xarr-db-repair/xarr-db-repair

这样可以避免后续因执行权限不足导致项目启动失败。

四、在宝塔面板中添加 Go 项目

第一步：进入 Go 项目管理

打开宝塔面板，依次进入：

网站 → Go项目 → 添加项目

图1：进入 Go 项目添加页面

图1展示的是在宝塔面板中进入 Go 项目管理页面的入口。
操作顺序如下：

1. 左侧点击 网站
2. 顶部切换到 Go项目
3. 点击 添加项目

完成后会弹出“添加 Go 项目”的配置窗口。

第二步：选择项目执行文件

在“添加 Go 项目”弹窗中，点击执行文件右侧的文件选择按钮，找到刚才上传的程序文件：

/www/go_project/xarr-db-repair/xarr-db-repair

选中后点击“确认”。

图2：选择 xarr-db-repair 可执行文件

图2展示的是在文件选择窗口中，定位到程序所在目录后，选中 xarr-db-repair 文件并点击确认的过程。

这里要特别注意：

• 必须选择实际的二进制执行文件
• 不要选错为目录或其他脚本文件
• 建议提前确认该文件已经具有执行权限

第三步：填写项目启动信息

文件选择完成后，按如下方式填写项目参数。

1. 项目名称

建议填写：

xarr_db_repair

2. 项目端口

填写：

8088

3. 放行端口

勾选“放行端口”，确保宝塔防火墙允许访问 8088。

4. 执行命令

建议填写为：

/www/go_project/xarr-db-repair/xarr-db-repair --addr=0.0.0.0:8088

这里的 --addr=0.0.0.0:8088 表示程序监听所有网卡的 8088 端口，方便通过服务器 IP 直接访问。

5. 环境变量

保持默认即可，一般选择“无”。

6. 运行用户

可按面板默认配置，一般为：

www

7. 项目备注

建议填写：

xarr_db_repair

全部填写完成后，点击“确定”。

图3：填写 Go 项目启动参数

图3展示了项目参数的填写方式，重点包括：

• 项目名称
• 项目端口 8088
• 放行端口
• 执行命令
  /www/go_project/xarr-db-repair/xarr-db-repair --addr=0.0.0.0:8088

这一步是部署过程中最关键的配置项之一，如果执行命令填写错误，程序将无法正常启动。

五、启动完成后的访问方式

项目启动成功后，可通过浏览器访问：

如果当前是在本机访问，也可以使用：

如果页面无法打开，请优先检查以下内容：

• Go 项目是否已正常启动
• 宝塔防火墙是否已放行 8088
• 服务器安全组是否开放 8088
• 程序是否被其他进程占用相同端口
• 执行命令路径是否正确

六、进入系统后的使用流程

程序启动成功后，即可进入 xarr-db-repair 的管理界面。左侧为数据库连接配置区，右侧为数据库信息、结构对比和修复概览区域。

图4：xarr-db-repair 管理界面

从图4可以看到，系统界面主要分为以下几个部分：

• 左侧：数据库连接配置
• 中间：当前数据库信息
• 右侧：结构对比结果
• 下方：修复概览与执行区域

实际使用时，建议严格按照页面按钮顺序操作。

七、配置数据库连接

在左侧“数据库连接”区域，依次填写目标数据库信息。

需要填写的内容

MySQL 地址

例如：

端口

例如：

数据库名

填写需要检查和修复的数据库名称，例如：

数据库用户

填写数据库账号，例如：

数据库密码

填写对应数据库密码。

八、选择修复策略

在“默认数据策略”下拉框中，建议选择：

该策略更适合生产或正式业务环境，优先以稳妥方式补齐缺失结构，尽量减少不必要的风险。

如果当前只是测试环境，也建议先从安全策略开始，确认结果后再进行后续操作。

九、推荐勾选项

1. 自动预检

建议勾选。
勾选后，每次修改连接信息后会自动触发预检，更方便快速确认当前数据库状态。

2. 错误即停止

建议根据实际情况选择。
如果你希望修复过程中一旦出现异常立即停止，避免继续执行，可勾选此项。

十、正确的使用顺序

为了保证使用过程更安全，建议按以下顺序操作。

第一步：测试连接

先点击：

确认程序能够正常连接目标数据库。
如果连接失败，请先检查地址、端口、账号、密码和数据库权限。

第二步：读取库信息

连接正常后，点击：

此时程序会读取当前数据库的基础信息，并在右侧展示数据库、表数量、字段数量、索引数量等概览内容。

第三步：立即预检

确认连接正常后，点击：

程序会根据内置的 xarr.sql 对照结构，对当前数据库进行结构比对，识别以下问题：

• 缺失表
• 缺失字段
• 缺失索引
• 是否需要修复
• 结构差异情况

右侧面板中的“结构对比”“修复概览”“等待预检”等区域会同步显示结果。

第四步：确认预检结果

预检完成后，建议重点查看以下信息：

• 当前数据库是否存在缺失表
• 当前数据库是否存在缺失字段
• 当前数据库是否存在缺失索引
• 是否存在需要修复的结构项
• 风险分布和待修复数量

如果发现问题较多，建议不要直接在生产环境一次性全部修复，应先确认影响范围。

第五步：执行修复

确认预检结果无误后，再点击：

程序会按当前所选策略执行修复操作，对缺失结构进行补齐。

这里建议遵循以下原则：

• 先在测试环境验证
• 先预检，后修复
• 先备份，再执行
• 核心业务库谨慎操作
• 修复后及时复核结果

十一、修复完成后建议检查的内容

修复执行完成后，建议至少检查以下几个方面：

1. 页面状态是否恢复正常

确认原本因结构缺失导致的页面报错是否已消失。

2. 接口是否恢复

检查与数据库结构相关的接口是否已能正常返回。

3. 后台功能是否恢复

例如订单、支付、配置、用户管理等模块能否正常打开和保存。

4. 数据库结构是否已补齐

可再次点击“立即预检”，确认缺失项是否已经归零或明显减少。

十二、常见问题处理

1. Go 项目添加成功，但启动失败

请重点检查：

• 二进制文件是否存在执行权限
• 执行命令是否填写为完整绝对路径
• 端口 8088 是否已被占用
• 程序文件是否上传完整
• 运行用户是否具备目录访问权限

建议重新执行：

2. 程序已启动，但页面无法访问

请检查：

• 宝塔防火墙是否已放行 8088
• 云服务器安全组是否开放 8088
• 启动参数是否为 --addr=0.0.0.0:8088
• 是否误写成 127.0.0.1:8088 导致只能本机访问

3. 数据库连接失败

请检查：

• MySQL 地址是否正确
• MySQL 端口是否正确
• 数据库名是否填写错误
• 用户名密码是否正确
• 数据库是否允许当前服务器访问

如果数据库和程序不在同一台服务器，还需要确认网络是否互通。

4. 预检有结果，但不能直接修复

这种情况通常说明当前数据库存在待确认问题，或者你还没有完成完整的连接、读取和预检流程。
建议按顺序重新执行：

十三、安全建议

为了保证工具使用更加规范，建议在正式环境中遵循以下原则：

• 不要在未备份数据库的情况下直接修复
• 尽量先在测试环境验证
• 不建议将 8088 端口长期完全暴露到公网
• 如有条件，建议通过反向代理或访问控制进行限制
• 每次修复后保留操作记录，便于后续追踪