✨ 前言
作为开源缺陷管理工具，MantisBT 是开发、测试团队管理项目缺陷的常用利器。本地部署 MantisBT 时，小皮面板（phpStudy）凭借一键式 LAMP 环境集成，大幅降低了环境搭建门槛，成为很多人的首选。
但部署过程中，不少人都会踩同一个大坑：明明所有配置都正确，却始终被浏览器的「HTTPS 强制升级」卡住，访问一直报 ERR_SSL_PROTOCOL_ERROR，折腾半天也找不到原因；同时还会遇到账号体系混淆、登录失败等问题，迟迟无法完成部署。
本文将完整记录从 0 到 1 用小皮面板部署 MantisBT 的全流程，从环境准备、源码部署、系统安装，到所有踩坑点的排查与解决，形成一份可直接照着操作的保姆级指南，帮你一次搞定本地 MantisBT 环境搭建，少走弯路。
一、目的
1. 掌握 Web 运行环境的搭建与配置方法。
2. 完成 MantisBT 缺陷管理系统在本地环境的部署与安装。
3. 实现 MantisBT 系统正常启动、管理员登录与功能可用性测试。
4. 学会排查部署过程中的常见问题，完成可正常使用的缺陷管理平台搭建。
二、内容
1. 搭建 Apache + MySQL + PHP 运行环境。
2. 创建 MantisBT 所需数据库与用户。
3. 部署 MantisBT 源码并完成系统安装配置。
4. 使用管理员账号登录系统，验证系统可正常访问与使用。
5. 对部署过程中出现的问题进行排查与解决。
三、过程
1. 环境准备
下载并安装 phpStudy 小皮面板，点击启动 Apache 和 MySQL 服务，如左图，启动成功后如右图即可启动成功，确保环境正常运行。
2. 创建网站和配置域名
在 phpStudy 中新建网站，设置域名为 mantis.local，指定网站根目录，完成本地域名配置。
1) 点击左侧网站菜单栏
2) 再点击创建网站设置域名为 mantis.local
3) 端口改为8888其他默认点击确认
3. 修改PHP版本
1) 点击左侧软件管理菜单找到php7.4.3安装否则会登录不了显示报错。
2) 安装好后到网站菜单栏里点击管理php版本切换为php7.4.3重启Apache
4. 创建数据库
在 phpStudy 的数据库管理中，新建数据库 mantisbt，创建数据库用户 root1并设置密码。
1) 点击创建数据库这里会提示先修改数据库密码需要先修改密码
2) 新建数据库 mantisbt，创建数据库用户 root1并设置密码。
5. 部署Mantisbt源码
将 MantisBT 源码解压到 Web 服务根目录，配置访问路径，确保浏览器可正常访问安装页面。
1) 访问官网mantisbt.org 进入后下载Mantisbt源码
2) 将下载好的文件解压到你安装PHP小皮的根目录的www文件下
3) 将mantisbt文件里的所有内容ctrl+A全选复制到mantis.local文件里
6. 登录测试
访问系统浏览器输入127.0.0.1:8888本机地址登录页面，使用管理员账号登录，验证页面加载、功能菜单、权限控制是否正常。
1) 进入页面进行数据填写然后点击页面底部的 「安装 / 升级数据库」
2) 所有的显示绿色就可以正常进行了
3) 重新输入http://127.0.0.1:8888本机地址进入就到了登录页面
4) 这时候只需找到mantis.local文件夹删除admin文件夹
5) 删除后登录的用户名为默认administrator密码为默认的：root就可以进去了
四、结果分析
（一）运行问题与解决
1. 问题 1：访问报ERR_SSL_PROTOCOL_ERROR
原因：误将网站端口设为https 443，本地无 SSL 证书，协议校验失败。
解决：切回http 80端口，重启 Apache 服务。
2. 问题 2：修正后仍无法访问，多浏览器报错
原因：新版浏览器默认开启「自动 HTTPS 升级」，强制将 80 端口的 HTTP 请求跳转 HTTPS，且域名存在 HTTPS 缓存。
解决：将端口改为自定义8888，绕开浏览器默认端口的强制升级，通过http://127.0.0.1:8888正常访问。
3. 问题 3：安装后登录失败
原因：混淆了「数据库账号」和「系统登录账号」，用安装时的数据库账号root1登录系统。
解决：使用 MantisBT 默认超级管理员账号administrator/root登录，登录后修改默认密码。
4. 其他问题：源码目录嵌套错误，修正为根目录直接存放核心文件；80 端口占用，通过改8888端口解决。
（二）经验与教训
部署前需全面校验协议、端口、目录、服务等配置，避免遗漏。
新版浏览器的 HTTPS 自动升级是本地 HTTP 服务的常见坑，优先用自定义端口绕开限制。
分清系统的「数据库账号」和「登录账号」两套独立体系，避免登录失败。
严格遵守安全规范，安装后删除admin目录、修改默认管理员密码。
多浏览器报错时，先排查环境配置，再排查浏览器 / 网络限制，用curl快速定位问题。
五、拓展
(一) 技术原理
1) HTTPS 自动升级：仅对 80/443 等标准端口生效，自定义端口会保留用户输入的协议，因此可绕开强制跳转。
2) MantisBT 账号体系：数据库账号用于初始化系统，登录账号用于系统访问，两层相互独立保障安全。
(二) 应用价值
1) 本次搭建的 MantisBT 本地环境可直接用于软件开发的缺陷跟踪、项目管理，掌握了 LAMP 环境搭建、浏览器网络机制等核心技术，为企业级项目管理工具运维奠定基础。
