metersphere项目在windows下部署(全网最全记录,所有的坑都有)

前言: 这是第一次接触java项目,所以踩了很多很多坑,真是一点一点摸索着过来的,如果能帮到大家,希望给我个赞

介绍

MeterSphere 是一站式开源持续测试平台,涵盖测试跟踪、接口测试、UI 测试和性能测试等,全面兼容 JMeter、Selenium 等主流开源标准,有效助力开发和测试团队在线共享协作,实现端到端的测试管理跟踪可视化、自动化测试、性能测试及融入持续交付 DevOps 体系,并充分利用云弹性进行高度可扩展的自动化测试,从而加速高质量的软件交付,推动中国测试行业整体效率的提升

产品优势

开源:基于开源、兼容开源,按月发布新版本、日均下载安装超过100次、被大量用户验证。
一站式:全面涵盖测试跟踪、接口测试、UI测试、性能测试并打通联动。
全生命周期:满足从测试计划、测试执行到测试报告分析的全生命周期需求。
持续测试:无缝对接 Bug 管理工具和持续集成工具等,将测试融入持续交付和 DevOps 体系。
团队协作:支持团队协作和资产沉淀,无论团队规模如何,总有适合的落地方式。

主要功能

测试跟踪:对接主流项目管理平台,测试过程全链路跟踪管理;列表脑图模式自由切换,用例编写更简单、测试报告更清晰。
接口测试:集 JMeter、PostMan 易用性和功能性于一体; 支持API 管理、Mock 服务、场景编排、扩展协议等。
UI 测试:基于 Selenium 浏览器自动化,高度可复用的测试脚本;无需复杂的代码编写,人人都可开展的低代码自动化测试。
性能测试:兼容 JMeter 的同时补足其分布式、监控与报告以及管理短板;帮助团队实现高并发、分布式的性能压测,完成压测任务的统一调度与管理。

前置环境

  • 项目仓库地址: https://gitcode.com/metersphere/metersphere/tree/v2.10
  • 依赖包地址: https://github.com/liuruibin/ms-jmeter-core/tree/v2.2
  • JDK版本: 17.0.10
  • node: 20.9.0
  • mysql: 8.0.36
  • maven: 3.96
  • redis
  • zookeeper
  • kafka
  • IEDA

项目下载

  • 项目版本是2.2的,ms-jmeter-core也是V2.2(版本不能下载错,否则打包时会出现依赖错误)
    依赖版本
    在这里插入图片描述

解压打包

  • 解压到对应文件夹,使用IDEA打开,同时新窗口打开ms-jmeter-core项目
  • 先将ms-jmeter-core项目打包(如果没有配置maven的,记得先去下载配置好)
# 进入终端ms-jmeter-core路径下 执行命令
mvn clean install

在这里插入图片描述

在这里插入图片描述

在metersphere项目中导入刚打包好的依赖

在这里插入图片描述

前端运行

打开终端,进入主目录下的frontend目录,执行命令,安装前端依赖

npm install 

在这里插入图片描述

完成后执行打包命令,这一步应该会出错,出错是因为node环境太高的问题,按照下图进行修改

npm run build
# 修改
"build-win": "SET NODE_OPTIONS=--max_old_space_size=4096 --openssl-legacy-provider && vue-cli-service build",
# 修改后重新执行
npm run build-win
# 构建成功后执行
npm run serve

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

配置后端

打开metersphere项目
在终端执行mvn install
在metersphere项目根目录下创建\opt\metersphere\conf\metersphere.properties文件
将下面的代码粘贴进去


# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/metersphere_dev?autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false
spring.datasource.username=root
spring.datasource.password=123456
  
# kafka 配置,node-controller 以及 data-streaming 服务需要使用 kafka 进行测试结果的收集和处理
kafka.partitions=1
kafka.replicas=1
kafka.topic=JMETER_METRICS
kafka.test.topic=JMETER_TESTS
kafka.bootstrap-servers=localhost:9092
kafka.log.topic=JMETER_LOGS
kafka.report.topic=JMETER_REPORTS
  
# node-controller 所使用的 jmeter 镜像版本
jmeter.image=registry.fit2cloud.com/metersphere/jmeter-master:0.0.6
  
# TCP Mock 端口范围
tcp.mock.port=10000-10010
  
# Redis 配置
spring.redis.host=localhost
spring.redis.port=6379
spring.redis.password=123456
  
# 启动模式,lcoal 表示以本地开发模式启动
run.mode=local

新建\opt\metersphere\bin目录,把backend/src/main/resources/jmeter/bin 目录下的配置文件拷贝到这个目录下
在这里插入图片描述

修改Application.java、logback.xml、generatorConfig.xml中的metersphere.properties路径
复制metersphere.properties的绝对路径,在三个文件中修改
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

修改base.properties文件中jmeter.home,指向/opt/metersphere/bin目录
在这里插入图片描述

运行后端

进入到backend目录,输入打包命令.打包完成后,修改运行配置,出现错误请看后面

mvn clean install

在这里插入图片描述

按照图片进行勾选
在这里插入图片描述
点击绿色箭头,运行项目,出现下面的内容就是运行成功了
在这里插入图片描述打开前端页面,输入用户名.用户名:admin 密码:metersphere 进行登录
在这里插入图片描述

bug及解决办法

1.在后端构建时,出现错误
原因:缺少文件夹
解决:先运行前端或者在前端目录下创建dist文件夹
在这里插入图片描述
2.在后端构建时,出现错误: 程序包io.metersphere.xpack.ui.dto不存在
原因: xpack是企业包,这里要付费才能使用
解决: 注释掉
在这里插入图片描述
在这里插入图片描述
3.后端构建时,出现错误
原因:通过观察,这错误是在文件中引入失败的
解决:注释,重新打包
在这里插入图片描述
在这里插入图片描述
4.运行时出现错误:Public Key Retrieval is not allowed
解决:在\opt\metersphere\conf\metersphere.properties中的spring.datasource.url中添加allowPublicKeyRetrieval=true参数
在这里插入图片描述
在这里插入图片描述
5.运行时出现错误:Schema metersphere_dev contains a failed migration to version 68
原因:迁移错误
解决: 可以找到项目路径\backend\src\main\resources\db\migration\V68__modify_api_test_case.sql文件,将其中的sql复制到Navicat(或其他数据库管理软件)中执行,执行成功后将metersphere_version表中对应行的success值改为1
在这里插入图片描述
6.前端执行命令:npm run build-win时出现错误: 提示xpack文件夹不存在
解决: 在frontend/src/business/components目录下创建xpack文件夹

7.运行项目,出现错误: 文件名或扩展名过长
解决
方法1:修改系统
修改最大长度限制
打开命令提示符,输入REGEDIT
找到路径:计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
修改LongPathsEnabled的值为1,点击确定
重启电脑生效
方法2: 修改命令路径
将文件复制到另一个名称较短的文件夹
方法3: 修改运行配置
编辑运行配置-进行修改选项 - 选择缩短命令行

8.运行项目时,出现错误: Cannot invoke “io.metersphere.base.domain.FileContent.getFile()” becavse “value” is null
原因:数据库迁移时出现的错误,数据表不完整.通过debug错误断点可以看到,是因为file_metadata中没有latest字段,在第130号迁移文件中,有几句SQL语句执行没有生效,数据库中无对应字段,导致报错
解决:把这几句SQL放到数据库客户端软件中手动执行,执行成功后要刷新表
在这里插入图片描述
在这里插入图片描述
9.运行项目时,正常运行,在打开前端页面,输入用户名/密码登录时,出现错误:sol error happened, please check logs.
原因:检查了数据库和密码,应该是没错的,还是数据库某些字段缺失的问题
解决:导入服务端生成的SQL脚本
导入步骤:
打开DBeaver
找到对应数据库→ 右键 →工具 →执行脚本
导入SQL脚本,点击开始,刷新数据库
在这里插入图片描述
在这里插入图片描述
10.导入服务端SQL脚本后运行项目,出现错误:invalid stream header: 504B0304
原因: 在file_content中存在原Linux系统的数据,生成的file和windows系统生成的对象输入流不同,无法解析
解决: 删除file_content中的数据,重新生成,同时删除file_metadata表中的关联数据,重新启动
在这里插入图片描述
在这里插入图片描述
11.有时候构建项目时也会出现包导入的问题,这个要检查maven配置,修改后重新构建

  • 38
    点赞
  • 26
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: 要在Windows上安装Metersphere,您可以按照以下步骤操作: 1. 首先,确保您的Windows系统满足Metersphere的最低系统要求。 2. 下载Metersphere的安装包,可以从官方网站或GitHub上下载。 3. 解压缩安装包,然后打开命令行窗口。 4. 进入解压缩后的Metersphere目录,执行以下命令: ``` ./install.bat ``` 5. 等待安装完成,然后启动Metersphere。 6. 在浏览器中输入Metersphere的地址,即可开始使用。 注意:在安装过程中可能需要配置Java环境变量和数据库等相关配置。具体操作请参考Metersphere的官方文档。 ### 回答2: Metersphere是一款企业级的开源自动化测试平台,支持多种语言和协议的自动化测试,并且具备丰富的测试报告和分析功能。本文将介绍在Windows系统上安装Metersphere的步骤。 1、环境准备 在开始安装Metersphere前,我们需要先准备好以下环境: - JDK 8 以上版本 - MySQL 5.7 以上版本 - Maven 3.0 以上版本 2、下载Metersphere 我们可以从Metersphere的官网上下载最新版本的Metersphere,或者从GitHub上下载最新的开源代码进行构建。这里我们推荐先下载最新的预编译版本,以方便快速进行安装。 3、创建MySQL数据库 Metersphere的数据存储使用的是MySQL,因此我们需要先创建一个数据库,并创建数据表以存储Metersphere的数据。 创建数据库可以使用MySQL Workbench等工具,或者在命令行中进行操作。以下是在命令行中创建数据库的示例命令: mysql -uroot -p CREATE DATABASE metersphere; GRANT ALL PRIVILEGES ON metersphere.* TO 'metersphere'@'%' IDENTIFIED BY 'metersphere'; FLUSH PRIVILEGES; 4、配置Metersphere 解压Metersphere的压缩文件,然后进入conf目录,编辑application.yml文件,根据自己的需要进行配置。 在application.yml文件中,需要配置以下几个参数: - spring.datasource.url:MySQL数据库的连接地址 - spring.datasource.username:MySQL数据库的用户名 - spring.datasource.password:MySQL数据库的密码 - FileUploadFolder:Metersphere的上传文件存储目录,可以设定为任意目录 - Jwt-secret:Metersphere使用的密钥,用于加密认证信息 其他参数可以根据需要进行适当调整。 5、编译Metersphere 进入Metersphere解压后的根目录,使用命令行执行以下命令,进行编译: mvn clean package -Dmaven.test.skip=true Maven会将编译后的Metersphere打包为一个可执行的jar文件,并存放在target目录下。 6、运行Metersphere 完成编译后,我们就可以执行以下命令,运行Metersphere: java -jar metersphere.jar 启动成功后,我们可以在浏览器中访问http://localhost:8080/,进入Metersphere的登录界面。 7、登录Metersphere 初始情况下,Metersphere没有任何用户,因此我们需要先通过注册功能创建一个管理员账户,然后在登录界面进行登录。 至此,Metersphere在Windows系统上的安装部署已经完成。如果需要在生产环境中使用,建议采用Nginx等反向代理服务器对Metersphere进行代理和负载均衡,以保障系统的稳定性和可用性。 ### 回答3: Metersphere是一个开源的性能测试框架,可以帮助开发人员进行性能测试,并发测试等测试工作。它支持多种开源工具集成,例如JMeter,Gatling等。本文将介绍如何在Windows上安装Metersphere。 步骤一:安装Java环境 Metersphere是一个基于Java开发的应用,因此需要安装Java环境。首先,需要前往官网下载并安装最新版的Java JDK(Java Development Kit)。 步骤二:下载Metersphere 在Metersphere官网下载页面,获取Metersphere的压缩包。 步骤三:解压并配置环境变量 将下载好的压缩包解压到本地路径,例如D盘的metersphere目录下。解压后,在metersphere目录下会有以下目录结构: bin:该目录下有启动Metersphere的脚本文件 conf:该目录下是Metersphere的配置文件 data:该目录下是Metersphere存储测试数据的目录 web:该目录下是Metersphere的Web应用程序 config:该目录下是Metersphere的配置文件 将解压后的目录路径配置到环境变量中,例如: JAVA_HOME=D:\Program Files\Java\jre1.8.0_301 METERSPHERE_HOME=D:\metersphere PATH=%JAVA_HOME%\bin;%METERSPHERE_HOME%\bin;%PATH% 步骤四:启动Metersphere 打开命令行界面,切换到metersphere/bin目录下,执行以下命令启动Metersphere: startup.bat 启动成功后,可以在浏览器中输入http://localhost:8080/访问Metersphere的Web应用程序。 总结 以上就是在Windows上安装Metersphere的步骤。需要注意的是,为了获得更好的性能和体验,在配置Metersphere时需要保证Java环境和硬件配置符合Metersphere的要求。配置好Metersphere后,可以通过Web应用程序进行使用,并集成一些开源工具进行性能测试,提高开发的效率和质量。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值