企业官网建设流程全解析

简介：Katalon Studio 是一款面向 Web 自动化测试的集成工具，基于 Selenium 与 Appium 框架构建，内置数百个预定义关键字，适合希望跳过环境搭建、快速上手自动化测试的开发者与测试人员。相比用 Python 加 Selenium 自行搭建测试环境，它开箱即用，支持 spy 与 record 方式捕获页面元素并生成脚本，也可用 Java 和 Apache Groovy 自行编写脚本，并能从 CSV、Excel、数据库等数据源读取数据填充测试变量。本压缩包为 Windows 64 位 7.5.5 版本，共约 2000 个文件，以 html、js、jar、png、svg、css、dll、exe 等为主，涵盖界面资源、依赖库与运行组件，整体约 374MB。目前已有 1322 人学习下载，适合想系统掌握录制回放、元素定位与数据驱动测试的读者参考使用。

1. Katalon Studio 7.5.5 在 Windows 上的安装环境准备

Katalon Studio 7.5.5 这个版本号在自动化测试圈子里出现的频率不低，尤其是那些还在维护老项目的团队。我见过太多人拿到Katalon_Studio_Windows_64-7.5.5.zip之后直接双击解压，然后发现启动报错、浏览器驱动对不上、JDK 版本冲突，折腾一下午连登录界面都没看到。Katalon Studio 本身是个基于 Eclipse 的自动化测试 IDE，集成了 Web、API、Mobile 的测试能力，对新手友好，但它的环境依赖比想象中挑剔。这篇笔记面向的是需要在 Windows 64 位机器上把 7.5.5 这个特定版本跑起来的开发者，不管你是第一次装还是从旧版本迁移，下面的步骤和参数取舍都能直接抄。装之前先把环境列清楚，比装完再救火省事得多。

2. 安装前环境核对：JDK、系统版本与磁盘路径

2.1 JDK 版本选择与验证

Katalon Studio 7.5.5 内置了 JRE，但它的启动器仍然会读取系统环境变量里的JAVA_HOME。如果你机器上装的是 JDK 17 或更高版本，启动时大概率会看到Unsupported class file major version这类报错。7.5.5 这个版本对应的是 JDK 8 的字节码，稳妥做法是单独装一个 JDK 8，或者直接用安装包自带的 JRE。

我一般会先确认系统里有没有 JDK 8：

# 查看当前 Java 版本 java -version # 如果输出不是 1.8.x，检查是否安装了 JDK 8 # 在 Windows 上可以用 where java 看路径 where java

如果输出显示java version "1.8.0_xxx"，那就可以继续。如果显示的是 11 或 17，需要去环境变量里把JAVA_HOME临时指向 JDK 8 的目录，或者干脆在启动 Katalon 之前用命令行指定：

# 临时指定 JDK 8 路径启动 Katalon set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_301 katalon.exe

这里的关键参数是JAVA_HOME，它决定了 Katalon 启动时加载哪个 JVM。注意不要改系统全局变量，用set只在当前命令行窗口生效，避免影响其他依赖高版本 JDK 的项目。

2.2 Windows 系统版本与磁盘路径

Katalon Studio 7.5.5 官方支持 Windows 7 及以上，但实际用下来 Windows 10 和 Windows 11 的兼容性最好。Windows 7 上可能会遇到缺少api-ms-win-crt-runtime-l1-1-0.dll的问题，需要提前装 VC++ 运行库。

磁盘路径这块有个血泪经验：不要把 Katalon 解压到带中文或空格的路径下。比如D:\测试工具\Katalon这种路径，启动时 Eclipse 底层会报Could not find or load main class，而且报错信息不会直接告诉你路径有问题。我一般会放在D:\Tools\Katalon_Studio_7.5.5这种纯英文、无空格的目录。

2.3 浏览器驱动与 Web 测试依赖

如果你要用 Katalon 做 Web 自动化，7.5.5 版本默认捆绑的 ChromeDriver 版本比较老，对应的是 Chrome 80 左右。现在大家的 Chrome 早就自动升级到 120+ 了，直接跑 Web 测试会报session not created: This version of ChromeDriver only supports Chrome version XX。

常见做法是去 Katalon 的安装目录下找到configuration\resources\drivers，把里面的chromedriver.exe替换成和你本机 Chrome 版本匹配的驱动。或者更省事的办法：在 Katalon 的Project Settings > Desired Capabilities > Web UI > Chrome里指定chromedriver的绝对路径，让它用你单独下载的驱动。

# 查看本机 Chrome 版本 # 在 Chrome 地址栏输入 chrome://version # 然后去驱动下载页找对应版本，替换到 Katalon 目录 # 路径示例： # D:\Tools\Katalon_Studio_7.5.5\configuration\resources\drivers\chromedriver_win32\chromedriver.exe

这一步不做，后面录制脚本的时候会一直卡在打开浏览器那一步，而且报错信息藏在Console面板里，不仔细看根本找不到。

3. 解压与首次启动：从 zip 到可用界面的完整步骤

3.1 解压操作与目录结构确认

拿到Katalon_Studio_Windows_64-7.5.5.zip之后，不要用 Windows 自带的解压工具直接双击。自带工具对长路径和大量小文件的支持不好，解压到一半可能报路径过长或者文件损坏。我一般用 7-Zip 或者 Bandizip，右键选择「解压到当前文件夹」。

解压完成后，目录结构应该是这样的：

Katalon_Studio_Windows_64-7.5.5/ ├── katalon.exe # 主启动程序 ├── configuration/ # 配置文件目录 │ └── resources/ │ └── drivers/ # 浏览器驱动存放位置 ├── plugins/ # Eclipse 插件目录 ├── features/ # 功能模块 ├── jre/ # 内置 JRE └── readme.txt # 版本说明

确认katalon.exe存在，并且jre目录里有内容。如果jre目录是空的，说明解压不完整，需要重新解压。

3.2 首次启动与工作空间设置

双击katalon.exe启动。第一次启动会弹出一个窗口让你选择工作空间（Workspace）目录。这个目录是存放你所有测试项目的地方，建议单独建一个文件夹，比如D:\Katalon_Workspace。

注意：工作空间路径同样不要带中文和空格，否则项目创建时会报Invalid workspace location。

启动过程中会看到 Eclipse 的加载画面，大概持续 10 到 20 秒。如果卡在这个画面超过一分钟，大概率是 JDK 版本问题，回到 2.1 节检查JAVA_HOME。

启动成功后，会看到一个欢迎页面，左边是 Test Explorer，右边是工作区。这时候先别急着建项目，去Help > About Katalon Studio确认一下版本号是不是 7.5.5。有些第三方渠道下载的包版本号对不上，提前确认能避免后面脚本行为不一致。

3.3 激活与离线模式选择

Katalon Studio 7.5.5 启动后会要求登录 Katalon 账号。如果你只是本地跑脚本，不想登录，可以点Activate Later或者直接关掉登录窗口。7.5.5 这个版本对离线使用的限制不算严格，不登录也能创建和运行本地测试项目。

但要注意，不登录的情况下，某些插件市场（Katalon Store）的功能用不了，比如自带的 API 测试增强插件。如果你只需要 Web UI 自动化，离线模式完全够用。

# 如果启动时一直弹登录窗口，可以修改配置文件跳过 # 找到 Katalon 安装目录下的 katalon.ini # 在末尾添加一行： -Dkatalon.activation.skip=true

这个参数的作用是跳过启动时的激活检查，适合在内网环境或者不想登录的场景下使用。改完保存，重新启动katalon.exe即可。

4. 避坑与常见问题排查

4.1 启动报错 "Java was started but returned exit code=13"

现象：双击katalon.exe后弹出一个错误框，提示Java was started but returned exit code=13。

原因：系统里安装的 JDK 版本和 Katalon 内置的 JRE 架构不匹配。比如你装的是 32 位 JDK，但 Katalon 是 64 位版本，或者反过来。

解决：确认系统里安装的 JDK 是 64 位版本。在命令行执行java -version，如果输出里没有64-Bit字样，说明是 32 位 JDK，需要卸载后重新安装 64 位 JDK 8。或者直接在katalon.ini里指定内置 JRE 的路径：

# 编辑 katalon.ini，在 -vm 参数后指定内置 JRE -vm D:\Tools\Katalon_Studio_7.5.5\jre\bin\javaw.exe

注意-vm和路径要分两行写，路径里不要有引号。

4.2 创建项目时卡在 "Building workspace"

现象：新建项目后，右下角进度条一直显示Building workspace，等了十分钟还没结束。

原因：Katalon 在首次创建项目时会去下载依赖的 Maven 包，如果网络环境访问 Maven 中央仓库慢，就会卡住。

解决：检查网络连接，或者配置国内镜像。在 Katalon 安装目录下找到configuration\resources\gradle或者maven相关配置，把仓库地址改成国内可访问的镜像。如果只是本地测试，可以在创建项目时取消勾选Auto-download dependencies，后续手动添加需要的库。

4.3 录制 Web 脚本时浏览器闪退

现象：点击 Record 按钮后，Chrome 浏览器打开一瞬间就自动关闭，Console 里报ChromeDriver was started successfully之后就没有下文了。

原因：ChromeDriver 版本和本机 Chrome 版本不匹配，或者 Chrome 的自动更新导致驱动失效。

解决：按照 2.3 节的步骤替换chromedriver.exe。另外，在 Katalon 的Project Settings > Desired Capabilities > Web UI > Chrome里，把chromeOptions的--no-sandbox和--disable-dev-shm-usage加上，有时候能解决闪退问题。

# 在 Desired Capabilities 里添加参数 # 名称：args # 类型：List # 值：--no-sandbox, --disable-dev-shm-usage, --start-maximized

4.4 测试报告无法生成或打开空白

现象：测试执行完成后，点击Test Reports里的报告，打开是空白页。

原因：Katalon 7.5.5 默认用系统默认浏览器打开报告，如果默认浏览器是 Edge 或者某些安全设置较高的浏览器，可能会拦截本地 HTML 文件里的 JavaScript。

解决：把默认浏览器临时改成 Chrome，或者在 Katalon 的Project Settings > Report里把报告格式改成CSV或JUnit，避开 HTML 渲染问题。我一般会同时勾选HTML和CSV，HTML 看不了的时候直接看 CSV。

4.5 从旧版本迁移项目后 Groovy 脚本报错

现象：把之前 6.x 版本的项目导入 7.5.5 后，Groovy 脚本里大量报unable to resolve class。

原因：7.x 版本升级了 Groovy 引擎和部分 API，旧版本的import路径变了。

解决：在项目根目录右键选择Refresh，然后去Project > Clean清理一次。如果还有报错，检查Keywords目录下的自定义关键字，把com.kms.katalon.core开头的旧包名替换成 7.5.5 对应的新包名。常见做法是打开External Libraries看实际加载的 jar 包版本，对照着改 import。

5. 装完怎么验证：跑通第一个测试用例

装完不验证，等于没装。我一般会用一个最小化的 Web 测试用例来确认整套环境是否真的可用。步骤不复杂，但每一步都能暴露不同层面的问题。

5.1 创建验证项目与测试用例

打开 Katalon Studio，选择File > New > Project，项目名填Verify_Install，路径选之前建好的工作空间。创建完成后，在Test Cases目录右键新建一个测试用例，命名为Check_Open_Browser。

在脚本编辑区输入以下 Groovy 代码：

// 打开 Chrome 浏览器并访问一个本地 HTML 页面 import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI // 启动浏览器 WebUI.openBrowser('') // 访问一个简单的本地页面，避免依赖外网 WebUI.navigateToUrl('file:///D:/Tools/Katalon_Studio_7.5.5/readme.txt') // 等待页面加载完成 WebUI.waitForPageLoad(10) // 验证页面标题包含预期内容 WebUI.verifyMatch(WebUI.getPageTitle(), '.*Katalon.*', true) // 关闭浏览器 WebUI.closeBrowser()

这段代码的逻辑很直接：启动浏览器、打开一个本地文件、等待加载、验证标题、关闭浏览器。用本地文件而不是外部网站，是为了排除网络因素干扰，纯粹验证 Katalon 和浏览器驱动的交互是否正常。

5.2 执行测试与结果解读

点击工具栏上的Run按钮，选择Chrome作为目标浏览器。执行过程中观察几个关键点：

• Chrome 浏览器是否正常启动并打开文件
• Katalon 底部的Log Viewer是否显示Test Cases/Check_Open_Browser的每一步状态
• 执行结束后，Test Reports目录下是否生成了对应的报告文件夹

如果浏览器正常打开又关闭，Log Viewer 里每一步都是绿色对勾，说明环境没问题。如果某一步是红色叉号，点开看详细报错，对照第 4 章的排查条目处理。

5.3 命令行模式验证

除了在 IDE 里点按钮，Katalon 还支持命令行执行，这对后续集成到 CI 里很重要。在安装目录下找到katalon.exe，用命令行调用：

# 命令行执行测试用例 katalon.exe -noSplash -runMode=console -projectPath="D:\Katalon_Workspace\Verify_Install\Verify_Install.prj" -testCasePath="Test Cases/Check_Open_Browser" -browserType="Chrome"

参数说明：-noSplash跳过启动画面，-runMode=console表示控制台模式，-projectPath指定项目文件，-testCasePath指定要执行的用例，-browserType指定浏览器。命令行模式跑通，说明这套环境不仅能手动点，还能自动化调度。

从那以后我每次装完 Katalon，不管多急，都会先跑一遍这个最小用例。它花不了两分钟，但能帮你把 JDK、驱动、路径、报告这几个最容易出问题的环节一次性筛一遍。希望帮到你。

本文还有配套的精品资源，点击获取