1. 软件测试人员的本地环境三件套到底该怎么装先把话说在前面这篇内容是给软件测试人员、刚转行做测试开发、以及需要在自己电脑上搭一套 Web 项目调试环境的人看的。核心主题是 Redis、禅道、MySQL 三者在 Windows 本地环境下的安装和基本联通。很多人在培训班或者公司项目里见过“禅道 MySQL Redis”这套组合但真到自己电脑上动手装就会发现一堆问题MySQL 装完启动不了Redis 双击闪退禅道连不上数据库端口被占用版本不匹配。这些问题不是项目本身的 Bug绝大部分是安装顺序、配置参数和环境变量没处理好。我先给一个总的判断本地安装这套环境不需要特别高的电脑配置但需要你严格按顺序来并且弄清楚每个软件装完之后到底应该怎么验证。别急着把三个软件同时装上也别急着改一堆配置文件。先装 MySQL再把 Redis 跑起来最后装禅道这个顺序最稳。需要说明的是这里的操作基于 Windows 系统Linux 服务器部署的步骤会有些差异后面我会专门讲一下。2. 先花十分钟理清三者的关系再动手安装2.1 禅道为什么非要 MySQL又为什么需要 Redis禅道是一款开源的项目管理工具常用来做需求管理、缺陷跟踪、测试用例和发布管理。对于软件测试人员来说禅道几乎是日常工作里接触最多的系统之一。禅道默认使用 MySQL 作为数据存储所有用户、项目、缺陷、用例数据都放在 MySQL 里。如果你以前只会在浏览器里打开禅道从不关心后端结构那么这次安装会帮你把“数据存在哪里”“服务怎么启动”这两件事弄明白。Redis 在这套环境里的角色可能让不少人困惑。禅道的核心业务可以脱离 Redis 运行但开启 Redis 缓存后会话管理、缓存数据、部分并发场景下的性能表现会更好。所以本地学习时可以把 Redis 理解成“可以让禅道跑得更顺畅的辅助服务”它不是必选项但装上之后你能顺便学会 Redis 基本操作对测试人员后续做接口测试、性能测试也有帮助。2.2 版本选择是第一个坑别盲目下载最新版本地安装这种组合环境时不要看到官网有最新版就直接下载。禅道对 PHP 版本、MySQL 版本有一定兼容要求老版本禅道甚至只适配特定 MySQL 版本。最稳妥的办法是先确定你要安装的禅道版本再看该版本官方文档要求的环境版本最后下载对应的 MySQL 和 Redis。如果只是学习用途我更建议使用禅道官方提供的集成环境包它会把 Apache、PHP、MySQL 一起打包好减少不少折腾。但如果你希望把 MySQL 独立出来自己管理那就要用源码包或者一键安装包再单独配置数据库。2.3 本地安装需要准备什么在 Windows 上安装这套环境硬件门槛不高操作系统Windows 10 或 Windows 1164 位系统。内存建议 8GB 以上4GB 也能跑但会比较吃力。磁盘预留 5GB 以上空间三个软件加数据文件够用。管理员权限安装 MySQL 服务和禅道服务时部分步骤需要右键管理员身份运行。另外安装前先确认端口占用情况。MySQL 默认端口 3306Redis 默认端口 6379禅道自带 Apache 默认端口 80 或 8080。如果这几个端口被其他程序占用后面启动时会报错。可以用下面这个命令查看端口占用netstat -ano | findstr 3306 6379 80 8080如果看到端口已被占用先找出对应进程或者换一个不冲突的端口。我建议初学者不要急着换端口先把占用端口的程序关掉这样后面配置更省事。3. MySQL 安装最常出问题的一步先把服务跑起来3.1 下载 MySQL 时要注意的细节MySQL 官网下载地址是 mysql 官方网站的 downloads 页面但是在国内访问可能较慢。选择版本时如果你是学习用途MySQL 5.7 和 MySQL 8.0 都可以。不过要注意MySQL 8.0 的认证插件和 5.7 不同部分老版本工具连接时会报错。如果只是本地学习我更推荐使用 MySQL 8.0 的 ZIP 压缩包方式安装而不是 MSI 安装包。原因有两个一是 ZIP 包安装过程透明你能看到每个配置文件的位置二是解压后手动初始化数据库能帮你理解 MySQL 的目录结构和启动原理。当然如果你不想折腾MSI 安装包更省事图形化界面一步步点下去就行。这里我给出两种方式你根据自己的情况选择。3.2 MySQL ZIP 包安装流程第一步解压 MySQL 压缩包到一个没有中文和空格的路径比如D:\mysql-8.0.x-winx64第二步在解压目录下新建一个配置文件my.ini注意编码格式建议使用 UTF-8内容如下[mysqld] basedirD:/mysql-8.0.x-winx64 datadirD:/mysql-8.0.x-winx64/data port3306 character-set-serverutf8mb4 default-storage-engineINNODB这里有个容易踩的坑datadir指向的 data 目录不要手动创建最好让 MySQL 初始化时自动生成。如果自己建了空目录某些版本会报目录非空错误。第三步以管理员身份打开命令提示符进入 MySQL 的 bin 目录执行初始化命令mysqld --initialize-insecure--initialize-insecure会生成一个 root 用户并且密码为空。第一次学习时用这个方式最方便因为不用担心忘记初始密码。如果使用--initialize系统会生成一个随机密码在日志文件里很多人找不到这个密码就会卡住。第四步安装 MySQL 服务mysqld --install MySQL第五步启动服务net start MySQL如果提示服务启动失败百分之七八十是因为my.ini里的目录路径写错或者 data 目录没有正确初始化。先检查这两项再查日志。3.3 验证 MySQL 是否安装成功启动服务后在 bin 目录下执行mysql -u root -p因为初始化时用的是--initialize-insecureroot 密码为空直接回车就能进入 MySQL 命令行。进入后执行SELECT VERSION(); SHOW DATABASES;能正常显示版本号和数据库列表说明 MySQL 已经跑起来了。这里我要提醒一个细节很多人在这一步安装的是 MySQL 8.0然后拿老版本的 Navicat 或者旧驱动去连接会报caching_sha2_password相关错误。解决办法有两个一是换新版本客户端工具二是把 root 用户的认证插件改回mysql_native_password。我建议直接用新版本工具更省心。4. Redis 安装双击闪退不可怕关键是理解启动方式4.1 Windows 上 Redis 的常见安装方式Redis 官方并没有长期维护 Windows 版本这也是很多人下载 Redis 时容易困惑的地方。在 Windows 上常见的安装方式有两种使用微软或第三方维护的 Windows 版本。在 Docker 中运行 Redis 容器。如果你只是本地学习直接下载 Redis Windows 版本压缩包更简单。虽然版本可能不是最新的 Redis 7.x但对于学习 Redis 基本命令和配合禅道使用完全够用。如果你电脑已经装了 Docker也可以直接用 Docker 跑一个 Redis这种方式的隔离性更好也更接近真实服务器环境。但要注意Docker Desktop 本身对内存占用比较高低配电脑可能跑不动。4.2 Redis 压缩包安装步骤第一步把 Redis 压缩包解压到一个固定目录比如D:\Redis第二步打开目录确认里面有redis-server.exe、redis-cli.exe、redis.windows.conf等文件。其中redis-server.exe是服务端程序redis-cli.exe是客户端连接工具。第三步双击redis-server.exe如果出现一个命令行窗口说明服务端能正常启动。但很多人会遇到窗口一闪而过这种闪退通常不是程序坏了而是配置文件有问题或者端口被占用。这时不要急着双击运行改成用命令行启动方便看到报错信息cd D:\Redis redis-server.exe redis.windows.conf如果端口被占用会提示bind: Address already in use。先找到占用 6379 端口的进程并处理掉再重新启动。4.3 注册 Redis 为 Windows 服务每次启动都靠命令行窗口不太方便建议把 Redis 注册为 Windows 服务以后开机自动启动。以管理员身份打开命令提示符进入 Redis 目录执行redis-server.exe --service-install redis.windows.conf --loglevel verbose然后启动服务redis-server.exe --service-start服务启动后打开另一个命令行窗口用客户端工具验证redis-cli.exe -h 127.0.0.1 -p 6379进入 Redis 命令行后先执行一个最简单的命令PING如果返回PONG说明 Redis 服务端和客户端已经联通。4.4 Redis 可视化工具怎么选大多数人学 Redis 时都希望有个可视化界面而不是只盯着命令行。常见的 Redis 桌面管理工具包括 Redis Desktop Manager 和 Another Redis Desktop Manager。前者是老牌工具后者对 Redis 新版本的支持更好界面也比较清爽。我自己的建议是本地学习阶段先用命令行把五大数据类型摸一遍再上可视化工具。因为可视化工具容易让你忽视数据结构和命令本身等做面试准备或者排查线上问题时命令行的基本功更实用。可视化工具的连接配置很简单填主机地址、端口、密码即可。如果 Redis 没有设置密码密码留空就行。需要提醒的是Windows 上第三方 Redis 版本没有设置密码保护默认是空密码。如果电脑在公司内网且防火墙没有限制最好不要直接把 Redis 暴露到外部端口。本地学习没问题但在真实服务器上一定要设置密码和访问限制。5. 禅道安装从下载到登录重点看数据库配置5.1 装机之前先理解禅道的目录结构禅道的安装方式和普通软件不太一样。下载完成后解压出来的目录里包含 Apache、PHP、MySQL 等组件它是一种“集成环境”结构。初学者很容易犯一个错误把禅道解压后不知道启动哪个文件或者直接双击某个 exe以为就能打开网页。实际上禅道在 Windows 下通常是通过服务启动的安装好后你需要通过浏览器访问本地地址来使用系统而不是直接打开桌面程序。5.2 使用禅道一键安装包禅道官网提供 Windows 一键安装包这是最适合初学者和测试人员学习的方式。安装过程比较傻瓜化按照界面提示选择安装目录即可。安装完成后启动禅道服务。不同版本的启动方式可能稍有差异常见的启动方式是在安装目录下找到 start 相关脚本右键管理员身份运行。如果你的电脑上还跑着其他占用 80 端口的程序比如某个本地 Web 服务器禅道可能无法正常启动。这时可以先停掉其他程序或者修改禅道的端口配置。启动成功后浏览器访问http://localhost或者http://localhost:端口号看到禅道登录页面说明集成环境已经跑起来了。首次登录时管理员账号一般是 admin初始密码在官方文档或安装包说明里可以查到。这里要特别注意首次登录成功后系统很可能强制要求修改密码这是正常流程不用紧张。5.3 手动指定禅道使用已有 MySQL如果你不想用禅道自带的那套集成环境而是希望禅道连接你自己安装的 MySQL这就涉及到手动配置数据库连接。这种方式更接近生产环境但对初学者来说坑比较多。具体流程是先用 root 身份登录到你自己的 MySQL创建一个数据库比如CREATE DATABASE zentao DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;然后创建禅道专用数据库用户CREATE USER zentaolocalhost IDENTIFIED BY 你的密码; GRANT ALL PRIVILEGES ON zentao.* TO zentaolocalhost; FLUSH PRIVILEGES;接着修改禅道的数据库配置文件把主机地址、数据库名、用户名和密码改成你自己的。不同版本禅道的数据库配置文件路径不同一般会在 config 目录下。修改前先备份原文件修改后重启禅道服务。这里最容易出的问题有两个数据库编码不对禅道页面显示乱码。用户名密码或权限不对安装时报数据库连接失败。如果你第一次用一键安装包我不建议手动指定外部 MySQL。先把集成环境跑通再逐步改配置这样既能看到效果也更容易定位问题。6. 三个服务之间的联通测试怎么做才算真的装好6.1 用禅道验证 MySQL 是否正常浏览器打开禅道登录页面输入管理员账号密码登录创建一条测试需求或者提交一条缺陷。如果数据能正常保存刷新后还在说明禅道和 MySQL 的数据读写正常。如果禅道页面能打开但登录或保存时报数据库相关错误说明问题大概率出在数据库连接配置上。需要检查数据库服务是否启动、数据库名是否匹配、用户名密码是否正确、数据库编码是否符合要求。测试人员要学会一个习惯不要只报“禅道打不开”这种笼统的现象要能说出是页面打不开、登录报错、还是数据保存失败再配合服务状态和日志去排查。这种问题描述能力是测试工作里很值钱的基本功。6.2 检查禅道是否真正用上了 Redis禅道的 Redis 配置通常在配置文件里默认可能没有开启。如果你想启用缓存需要先确认 Redis 服务已启动然后在禅道配置文件里填写 Redis 地址和端口一般默认是 127.0.0.1:6379。开启后重启禅道服务。判断是否生效可以打开 Redis 命令行用以下命令查看当前键值数量INFO或者DBSIZE如果禅道使用的缓存数据写入了 RedisDBSIZE返回的键数量会变化。如果一直是 0说明禅道并没有真正连接上 Redis。需要注意禅道是否支持 Redis 以及开启方式不同版本有差异。如果版本太老可能压根不支持 Redis 配置或者配置项名称不同。遇到这种情况不要硬改配置先查一下自己版本对应的官方文档。6.3 用命令行把三者串起来验证如果你是软件测试人员我建议做一次“命令行联通测试”把整个环境的网络路径走一遍确认 MySQL 监听 3306 端口。netstat -ano | findstr 3306确认 Redis 监听 6379 端口。netstat -ano | findstr 6379确认禅道对应的 Web 服务监听 80 或 8080 端口。netstat -ano | findstr 80用浏览器访问禅道页面查看是否正常渲染。如果端口都在监听页面也能打开就说明三件套的基本链路已经通了。我还建议你用 MySQL 客户端连一次禅道的数据库查看表结构是否存在mysql -u zentao -p USE zentao; SHOW TABLES;能看到几十张数据表基本说明禅道初始化成功了。如果你对接口测试感兴趣还可以用 Postman 或 Apifox 调用禅道的 API 接口进一步熟悉它的鉴权方式和数据返回格式。7. 常见报错和排查思路照着这个顺序查7.1 MySQL 启动失败MySQL 启动失败是最常见的。先看现象如果服务启动后立刻停止看 Windows 事件查看器里的 MySQL 日志。如果是命令行启动看控制台输出的错误信息。排查顺序是先检查my.ini里的 basedir 和 datadir 路径是否正确再看 data 目录是否由程序初始化最后确认 3306 端口没有被其他程序占用。常见的一个坑是以前装过 MySQL残留服务或残留配置文件的影响导致新版启动失败。这种情况下先把旧服务卸载干净再重新安装。有些时候 MySQL 启动失败是因为安装目录或数据目录权限不足。尤其是使用 ZIP 包方式安装时如果目录放在C:\Program Files下可能会因为权限问题无法写入数据。解决办法是安装到用户目录或者 D 盘自定义目录。7.2 Redis 启动后闪退双击redis-server.exe闪退一般有三种原因端口被占用。配置文件格式错误。日志路径或数据持久化路径没有权限。排查时不要双击运行改用命令行运行并报错信息。如果必须保留数据持久化文件注意配置文件中dir指向的目录要存在且有写入权限。如果 Redis 能启动但redis-cli连接不上检查是否设置了bind限制。默认bind 127.0.0.1只允许本机连接本地学习没问题。不要轻易改成0.0.0.0除非你明确知道自己在做什么。7.3 禅道页面打不开或登录报错禅道页面打不开先看 Web 服务是否启动。再确认端口是否被占用。最后检查防火墙是否拦截本地端口。端口被占用时可以在配置文件里修改禅道监听端口。但要注意改完端口后访问地址也要同步修改。禅道登录报错如果是数据库连接错误检查数据库配置。如果是账号密码错误先确认是否没改初始密码。如果是验证码频繁错误可能是缓存或浏览器 Cookie 问题换无痕窗口试试。我见过不少同事遇到问题后先猜猜不出来就重装最后越装越乱。更有效的做法是先判断问题发生在哪一层再针对那一层查看日志和配置文件。禅道的日志一般放在log目录下MySQL 日志在数据目录里Redis 日志位置要看配置文件。7.4 几个容易被忽视的坑第一个坑是杀毒软件拦截。Redis、MySQL 这类软件有时会被安全软件提示风险导致服务启动失败或端口无法监听。如果安装过程中被拦截先把软件加入白名单安装完成后再退出或调整设置。第二个坑是系统用户名包含中文。有些软件在安装时会解析用户主目录如果路径包含中文可能导致程序读取配置文件失败。最优解是使用英文用户名或者安装时把软件装在纯英文路径下。第三个坑是 Te 环境变量。如果你装了多个 Python、Node.js、Java 或数据库版本环境变量 PATH 里的顺序可能影响命令执行。比如执行mysql命令时系统找到的可能不是你刚安装的那个版本。排查时用where mysql查看实际执行路径。8. 进阶建议从安装环境到测试工具链的延伸8.1 配置数据库和缓存是测试人员的底层技能很多测试人员觉得 MySQL 和 Redis 是开发的事但其实并不是。测试人员在测试过程中要构造测试数据、验证数据状态、排查前后端问题、分析性能瓶颈这些都需要你至少会看数据库表结构、会执行 SQL、会查看 Redis 缓存数据。装完这套环境后建议你至少学会下面几个操作登录 MySQL 查看表结构。创建用户和授权。执行增删改查 SQL。查看 Redis 中的 key。删除指定 key。查看 Redis 内存使用情况。这些操作不复杂但需要你亲手在命令行里敲一遍光看教程是记不住的。8.2 用禅道作为学习业务工具的场景禅道不只是部署练习对象它本身就是一件测试人员日常使用的工具。装好之后你可以自己建账号、建项目、提缺陷、建用例完整体验一遍测试管理流程。建议做两轮练习第一轮只用一个浏览器点击界面上的各个模块把需求、任务、缺陷、用例之间的流转关系弄明白。第二轮用管理员账号配置用户权限把不同角色看到的菜单和操作权限对比一下。这一步能帮你理解权限控制在后端测试、接口测试中经常用到。如果你以后要写接口测试脚本禅道也提供了 API 接口你可以尝试用 Python 调用禅道创建缺陷或查询用例。不过这个过程需要先登录获取会话 Token不同版本接口路径可能不同调试时要多看接口文档。8.3 以后真的要在服务器部署怎么办本地 Windows 环境跑通后放到真实服务器上部署时思路其实差不多但有几个区别第一服务器大多数是 Linux 系统安装命令不太一样。MySQL、Redis 可以用包管理器直接安装禅道则要上传安装包到服务器并设置目录权限。第二服务器环境要考虑防火墙、安全组、远程访问权限。比如 Redis 默认没有密码在服务器上必须设置密码并限制绑定网卡否则很容易被扫描工具探测到。第三生产环境更看重数据持久化和备份。MySQL 要定期备份禅道的附件和数据文件也要有备份策略Redis 要根据业务需求决定是否开启持久化。所以本地学习的最终目标不是把环境装上就完事而是要把安装、配置、启动、排查这一整套逻辑摸透。以后遇到新环境你至少不会再无处下手。8.4 给测试新人的一点建议如果你是刚入行的软件测试人员这套环境值得花一整天时间慢慢装一遍。先不要用一键优化脚本也不要全自动安装器一步一步手动装手动启动手动验证手动排查。这个过程会让你对服务器端口、进程、数据库、缓存服务有最直接的感知。安装过程中如果报错建议把报错信息完整复制下来不要只看最后一行。很多错误信息前面几行才是根因最后一行只是结果。我还建议你准备一个 Markdown 笔记把安装步骤、遇到的问题、解决办法、命令都记录下来。以后在工作中遇到别人报同样的错你可以直接给出一份排查清单。这种写文档的习惯是测试工程师从“点工”走向“工程师”的重要分水岭。最后说一句很多人容易忽略的环境装好之后不要急着清理压缩包和日志文件先把所有服务重启一遍确认没问题了再清理。这样才能真正判断出哪些服务是开机自启的哪些需要手动启动对你理解整套系统的运行方式会很有帮助。