自动化测试被放进持续集成的流水线里面去跑之后，慢慢就会发觉，真正容易出问题的往往已经不是测试脚本写得对不对了，而是更多集中在运行的环境、文件存放的路径、执行时的权限，还有被测程序本身是怎么被启动的这个方面上。要说清楚对Squish和Jenkins的集成工作到底应该怎样去配置，以及在Jenkins上面的任务跑失败了以后又该怎么去排查，这里面最核心的一个事情，就是需要让Jenkins能够稳稳当当地把squishrunner这个运行器的命令给调用起来，同时还必须保障squishserver服务、存放测试案例的套件、被测的应用程序，以及用来放置测试报告的目录，都能够被当前这台负责执行任务的节点机器正常地访问到。实际上，Squish这个工具是支持通过Jenkins里创建的任务来跑测试的，在这个过程里头，squishrunner会专门负责去执行测试的脚本，并且和squishserver之间进行通信。

界面自动化用例跑久了以后，图像差异常常会变成一类很烦人的问题。对于Squish图像校验要怎么设置，以及图像校验里面的阈值又要怎么调整，这里头的重点，其实并不是单纯地去截一张图然后拿来比较，而是先要把校验的对象、截图的区域范围、遮罩的部位，还有能接受的容差规则给确定下来。Squish里面提供的检查点，既可以在它的开发工具里面用选单的方式去建好，也可以直接通过写脚本的办法来产生，而图像类的校验，比较合适的路子，一般是先借助开发工具来生成，之后再去依照结果进行细调。

Squish脚本一开始看起来只是把录制结果改一改就能跑，但用例一多以后，最先失控的往往不是语法，而是复用边界。登录流程复制一份又一份，对象名散在各个脚本里，页面切换一改就要到处补。按Squish官方文档的原生结构来看，测试套件本身已经把测试用例目录、shared共享目录、对象库和全局脚本分成了不同层级，而且查找共享脚本时也有固定顺序。顺着这套结构来组织脚本，再去拆公共函数和页面对象，工程会稳很多。

很多人第一次用Squish，觉得录制很简单，点一下Record，跟着操作一遍，脚本就出来了。可真正麻烦的地方，往往不在第一遍能不能录出来，而在第二遍、第三遍以后脚本还能不能继续用。Qt官方文档把这条线说得很清楚：录制本身是从测试套件和测试用例开始的，录制过程中会自动把对象写进Object Map，后面脚本要不要好维护，很大程度上就取决于对象名、同步方式和共用代码有没有先收顺。

做Squish授权配置时，最容易弄混的不是安装程序，而是许可证模型本身。Qt官方现在把Squish的许可证模型分成三类，本地许可证、本地网络中的Squish Floating License Server，也就是FLS，以及Squish 9.2及更新版本可用的Qt License Server，也就是QLS。不同模型的配置方式完全不一样，本地许可证是把密钥直接配到客户端，本地浮动许可要让客户端连到一台运行中的许可服务，而QLS则是让客户端连接到一个许可证服务地址。所以真正开始配置前，先把当前组织到底用哪一种许可模型分清，后面的步骤才不会走反。

在Squish里，验证点并不只是“录一段脚本后顺手加一句判断”，它本质上是把界面状态、对象属性、截图或表格内容转成可重复执行的检查动作。官方文档明确说明，验证点既可以通过代码直接写，也可以通过IDE里的Verification Point Creator点选生成；而属性校验最常见的落地方式，就是用对象属性加`test.compare()`或`test.verify()`这样的验证函数来完成。

Squish录制回放不稳定，最常见的根源不是录制功能本身，而是对象名不稳、等待方式不对、以及把异步界面当成同步界面来回放。真正想把脚本跑稳，思路要从“多录几次试运气”改成“先固定对象识别，再把等待和同步点补全”，这样后面回归时才不会同一条用例今天过、明天挂。

做GUI自动化时，squish截图保存失败怎么办，squish截图路径怎么设置这类问题经常一起出现：一边是截图动作已经触发但文件没落盘，另一边是截图确实生成了却找不到保存位置。更常见的根因不在截图能力本身，而在结果目录与报告生成器的组合、运行端与被测端不在同一台机器、以及目录权限与文件名规则没统一。把截图写入链路理清，再把路径按运行方式固定下来，截图才能稳定成为可追溯证据。

Squish里最让人抓狂的不是一次失败，而是同一段脚本反复卡在等待上，日志里永远是超时，改大超时又把整套回归拖得很慢。要把这类问题处理干净，建议先把等待到底在等什么讲清楚，再把全局超时、按场景等待、按状态等待三套口径重设成一套可重复的规则，后续才不会越补越乱。

在用Squish做回归时，截图往往是定位问题的第一手证据，但不少团队会遇到两类尴尬情况，一类是明明启用了截图却不生成文件，另一类是生成了截图却找不到保存位置或被写到临时目录里。要把这件事做稳，建议先把截图的生成方式与保存目录的归属理清楚，再把结果目录与写入权限固定下来，后续不管在IDE还是CI里跑，截图都能落到同一套路径口径中。