5154

修改Mantis数据库是一个需要谨慎操作的过程，涉及数据结构调整、配置更新或功能扩展等场景，以下是详细的操作步骤、注意事项及工具使用说明,确保操作安全性和数据完整性。

操作前准备

1. 备份数据库
   在任何修改前，必须通过mysqldump（MySQL/MariaDB）或pg_dump（PostgreSQL）等工具完整备份数据库。

   mysqldump -u [用户名] -p [数据库名] > mantis_backup.sql

   备份文件需存储在安全位置,并验证可恢复性。

2. 确认数据库类型与版本
   Mantis支持MySQL、MariaDB、PostgreSQL等数据库，通过SELECT version();（MySQL）或SELECT version();（PostgreSQL）确认版本,避免语法不兼容问题。

3. 获取数据库结构信息
   使用SHOW TABLES;（MySQL）或\dt（PostgreSQL）列出所有表，重点关注核心表如mantis_user_table（用户表）、mantis_bug_table（缺陷表）等。

修改数据库的常用方法

直接通过SQL语句修改

适用于简单的字段更新或结构调整，修改缺陷表的优先级字段默认值：

ALTER TABLE mantis_bug_table MODIFY COLUMN priority TINYINT DEFAULT 3;

注意事项：

• 修改前需检查字段依赖关系（如外键约束）。
• 对于大型表，建议在低峰期操作,避免锁表导致服务中断。

使用Mantis内置脚本

Mantis提供admin_check.php等管理脚本，用于修复数据一致性。

php admin/check.php --fix

适用场景：修复因升级导致的数据结构异常。

通过插件扩展数据库

若需新增功能（如自定义字段），可通过插件实现，步骤如下：

• 在插件目录中定义install.php，包含数据库修改逻辑：

  $t_core_path = config_get('core_path');
  require_once( $t_core_path . 'class.database.php' );
  $query = "ALTER TABLE mantis_bug_table ADD COLUMN custom_field TEXT";
  db_query($query);

• 插件激活后,Mantis会自动执行安装脚本。

复杂修改示例：添加自定义字段

以新增一个“需求来源”字段为例，步骤如下：

1. 修改数据库表结构

   ALTER TABLE mantis_bug_table ADD COLUMN source VARCHAR(100) DEFAULT 'internal';

2. 更新Mantis配置
   在config_inc.php中添加字段定义：

   $g_custom_fields = array(
       array(
           'name' => 'source',
           'type' => 'string',
           'default' => 'internal'
       )
   );

3. 验证修改
   登录Mantis后台，检查新字段是否在缺陷提交页面显示,并测试数据写入与查询功能。

修改后的验证与维护

1. 数据一致性检查
   使用SELECT COUNT(*) FROM mantis_bug_table WHERE source IS NULL;确认字段是否为空，必要时执行批量更新：

   UPDATE mantis_bug_table SET source = 'internal' WHERE source IS NULL;

2. 性能监控
   对于索引修改（如CREATE INDEX idx_priority ON mantis_bug_table(priority);），需监控查询性能,避免索引过多影响写入速度。

3. 版本兼容性
   若从旧版本升级，需参考Mantis官方升级文档执行数据库迁移脚本，例如upgrade_2.0.0_to_2.1.0.sql。

   

常见问题与风险控制

• 风险：直接修改核心表（如mantis_user_table）可能导致用户认证失败。
• 规避措施：
  • 在测试环境验证SQL语句。
  • 使用事务（BEGIN; ... COMMIT;）确保原子性操作。

相关问答FAQs

Q1：修改Mantis数据库后，用户登录失败怎么办？
A1：首先检查mantis_user_table中username和password字段是否被误改，密码通常经过哈希处理，直接修改会导致认证失败，可通过重置密码功能恢复：

1. 登录数据库执行：UPDATE mantis_user_table SET password = md5('newpass') WHERE username = 'admin';
2. 清空浏览器缓存后重新登录，若问题持续,恢复备份并重新操作。

Q2：如何批量修改缺陷的状态字段？
A2：使用SQL的UPDATE语句结合WHERE条件，将所有“已关闭”的缺陷状态改为“已解决”：

UPDATE mantis_bug_table SET status = 80 WHERE status = 90;

注意：状态值需参考Mantis的mantis_enum_table表（如status列中的数字对应关系），避免使用无效状态值,操作前建议先备份数据库并在测试环境验证。