---
title: 引擎服务端和引擎客户端的版本不匹配故障处理
description: "当引擎服务端和引擎客户端使用的版本不一致时，引擎客户端会上报版本不匹配的结果，用户会从操作界面看到相关的提示信息（具体的提示信息取决于ISV的实现）。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengcps/boostcph/instrucstreamengine/kunpengcpsinstruction_20_0033.html
sourcePath: /source/zh/kunpengcps/boostcph/instrucstreamengine/kunpengcpsinstruction_20_0033.html
indexId: 9c0c89840379133b6b078d321bede797330f22f7471f78bc2d14d105dee7547685
---
# 引擎服务端和引擎客户端的版本不匹配故障处理

#### 现象描述

当引擎服务端和引擎客户端使用的版本不一致时，引擎客户端会上报版本不匹配的结果，用户会从操作界面看到相关的提示信息（具体的提示信息取决于ISV的实现）。


#### 对系统的影响

当此故障发生时，引擎客户端不会继续工作，引擎客户端上报版本不匹配结果后，会断开与引擎服务端的网络连接，并处于退出状态。

当此故障发生时，引擎服务端会被动断开与引擎客户端的连接，并从online运行状态切换为offline运行状态；offline运行状态下云手机里的APP依然会继续运行，但此时无法接收到引擎客户端的触控输入，APP的音频/绘制指令也无法传输到引擎客户端。


#### 可能原因

导致该故障，通常是因为使用了不同的引擎服务端版本和引擎客户端版本。

引擎客户端和引擎服务端存在大量的消息交互，必须保证两端使用同样的版本，才能确保消息包能正确的解析执行，因此对版本匹配要求严格。

引擎客户端每次连接引擎服务端，都会对引擎服务端的版本号做校验，当发现引擎服务端的版本与引擎客户端的版本不一致时，则上报版本不匹配的结果，并及时退出；避免后续引入更难以觉察的故障。


#### 操作步骤

1. 在引擎客户端生成的日志中，搜索“Failed to match version, version mismatch, server:XXX, client:XXX”的日志，根据日志描述确认错误的版本信息。
2. 根据上述提示信息，更新引擎服务端或者引擎客户端的版本。
3. 手机接入端重新连接云手机，业务恢复。