MantisBT 安裝配置與常見問題解決彙總

Mantis Bug Tracker 是經典的缺陷追蹤系統。本文記錄最新版（1.2.11）安裝過程中遇到的資料庫建立、配置檔生成、中文化、郵件設定等實戰問題及解決方案。

一、安裝階段常見問題

1. 資料庫未建立

提示：Your database has not been created yet...
解決：手動執行安裝頁面顯示的 SQL 建表語句。建議分兩批執行：CREATE TABLE 先行，ALTER TABLE 後行，避免外鍵依賴順序導致失敗。

2. config_inc.php 無法自動生成

權限不足或路徑問題。解決：手動建立 config_inc.php，複製安裝頁面提示的配置內容（資料庫連線、郵件設定等）。

3. 安全收尾

• 刪除整個 admin/ 安裝目錄
• 修改預設管理員 administrator 密碼，或新增管理員後禁用預設帳號

二、使用階段問題

1. date() 時區警告

php.ini 設定：date.timezone = Asia/Shanghai

2. 中文介面

編輯 config_defaults_inc.php 第 588 行：
$g_default_language = 'chinese_simplified';

3. mantis_config_table 缺資料

重新執行安裝 SQL 中針對 mantis_config_table 的 INSERT 語句。

4. 查看分配報錯 Unknown column 'user_id'

執行 mantis_bug_file_table 相關 ALTER TABLE 陳述句補齊欄位。

5. SMTP 郵件配置 (以 163 為例)

在 config_defaults_inc.php 設定：

$g_phpMailer_method = PHPMAILER_METHOD_SMTP;
$g_smtp_host = 'smtp.163.com';
$g_smtp_username = 'your_email@163.com';
$g_smtp_password = 'your_password';
$g_smtp_port = 25; // 或 465 (SSL)
$g_administrator_email = 'admin@yourdomain.com';
$g_webmaster_email = 'webmaster@yourdomain.com';
$g_from_email = 'mantis@yourdomain.com';
$g_return_path_email = 'mantis@yourdomain.com';

三、升級與維護建議

1. 升級前完整備份資料庫與 config_inc.php
2. 核心檔案勿直接修改，改用 custom_* 機制或插件擴展
3. 定期清理 mantis_bug_text_table 等大表歷史備份
4. 啟用 $g_compress_html = ON 減少頻寬

Mantis 輕量穩定、權限模型細緻，適合中小團隊缺陷管理。做好初始化配置與定期備份，長期維護成本極低。