start-server-and-test启动测试服务器后未运行测试用例问题排查

问题原因与解决方法 #

start-server-and-test启动服务后未执行后续测试，核心是工具未检测到服务就绪信号，常见问题对应解决方式如下：

• 健康检查配置不匹配
  你当前配置的默认检查路径是http://localhost:4001/，如果服务根路径没有返回2xx状态码（比如根路径404、有全局权限拦截、默认HEAD请求被拒绝），或者服务启动初始化耗时较长超过工具默认等待时间，都会导致工具一直处于等待状态不执行测试。
  解决方法：

1. 新增专用健康检查接口/health，逻辑仅返回200状态码，将ci命令的检查地址修改为http://localhost:4001/health
2. 明确指定GET请求校验+延长超时时间，ci命令修改为：start-server-and-test 'yarn test-server' 5000 http-get://localhost:4001/ 'yarn test'，其中5000为最长等待5000毫秒，http-get前缀指定用GET请求做校验。

• 端口绑定异常
  要确认你的app.ts中服务监听的端口是读取process.env.PORT环境变量，没有硬编码为其他端口，否则服务实际监听端口不是4001，工具无法检测到就绪状态。可手动执行yarn test-server后访问对应检查地址，确认能正常访问再排查其他问题。
• shell引号转义问题
  不同系统的shell对单引号解析逻辑不同，Windows cmd环境不支持单引号包裹命令，会导致参数识别错误。
  解决方法：
  将ci命令的单引号替换为转义后的双引号：

"ci": "start-server-and-test \"yarn test-server\" http://localhost:4001/ \"yarn test\""

如果是跨环境使用，也可以直接省略包管理器调用，让工具自动执行package.json内的脚本：

"ci": "start-server-and-test test-server http://localhost:4001/ test"

• 版本兼容问题
  如果安装了全局的start-server-and-test，可能存在全局版本和项目依赖版本不兼容的情况，可卸载全局版本后使用项目本地依赖执行即可。

内容的提问来源于stack exchange，提问作者Shadab