EVCC 常见问题与故障排查¶

最后更新：2026-09-06

面向普通用户的症状式排错手册。建议按顺序检查，不要一开始就清除应用数据或修改系统文件。

1. 通用排错顺序¶

遇到问题时，按以下顺序处理：

记录发生时间、操作步骤和可见提示；
确认主 EVCC 与 EVCC Mini 是否为配套版本；
检查设备是否联网、EVCC 是否已激活；
检查设置页中的 RootService、ADB、车辆数据源和目标服务状态；
关闭刚启用的实验功能、自动化或脚本；
重启 EVCC；涉及车机系统服务时再重启车机；
先使用“清除缓存”，保留用户配置；
仍无法解决时上传当前日志、上次日志或系统诊断日志；
只有在已备份配置且确认是本地数据损坏时，才考虑清除应用数据。

2. 安装、激活和迁移¶

2.1 安装失败¶

检查：

安装包是否完整；
车机是否允许 ADB 或应用管家安装；
存储空间是否充足；
是否安装了错误架构或不匹配版本；
更新时主 EVCC 和 EVCC Mini 是否都已下载完整。

优先使用 EVCC 自带更新入口或应用管家安装。手动安装失败时，保留安装提示或安装日志。

2.2 所有页面都被锁定¶

说明主 EVCC 尚未激活或暂未取得激活状态：

点击顶部设备 ID，复制后提供给管理员；
或在 EVCC 本体在线激活页输入设备 ID 和激活码；
保持 EVCC 联网，等待自动刷新；
如果提示云端尚未发现设备，先打开 EVCC 并等待心跳上报；
如果提示设备处于异常状态，联系管理员核对。

2.3 EVCC Mini 激活失败¶

先确认主 EVCC 本体已激活；
在主 EVCC 的 Mini 编辑器中开始试用或输入 Mini 激活码；
检查激活码是否已绑定其他设备、被撤销或触发限流；
老版本提示“未知错误”时，先把主 EVCC 和 Mini 一并更新到配套版本；
仍失败时上传当前日志，并提供设备 ID 和发生时间。

2.4 重置车机后无法自动迁移¶

自动迁移需要旧、新设备的关键身份信息能够正确匹配。建议：

新设备安装并打开 EVCC，保持联网；
等待 VIN、SN 和车型信息获取完成；
看到迁移确认后再操作；
没有弹窗时使用公开迁移页；
提示旧设备不存在、已删除或已迁移时，把完整提示和新旧设备 ID 提供给管理员。

迁移完成后，原设备 ID 会失效，Mini 权益会按规则跟随迁移。

3. RootService、ADB 和数据源¶

3.1 RootService 无法连接¶

确认设备具备当前车型要求的 Root 条件；
在设置页刷新 RootService 状态；
使用 Ping 或亮度测试确认权限是否真正生效；
检查是否刚升级但没有重启车机；
终止 RootService 后让 EVCC 自动重新启动；
上传日志，说明“RootService 无法连接”。

如果只有某个高权限动作失败，而其他 RootService 测试正常，应重点检查该动作本身，而不是反复重启 RootService。

3.2 ADB Shell 无法连接¶

使用应用管家确认“永久开启无线 ADB”已生效；
确认应用管家本身显示已连接；
检查车机网络和调试开关；
部分车型需要重新完成新手引导中的 ADB 授权；
不要长期打开 ADB Remount，除非正在执行明确需要写系统分区的操作。

3.3 VHAL/APVP/AIDL/CAPI/AdaptAPI/SOA 没有数据¶

确认当前车型确实支持该数据源；
检查对应连接开关和状态指示；
先刷新或重新进入属性页；
检查云端车型适配是否已经获取；
同一个功能可尝试其他数据源，但不要假设不同来源值域相同；
只有某个属性缺失时，可能是车辆本身没有暴露，不一定是 EVCC 故障。

3.4 属性可以读但不能写¶

检查访问类型是否为可写；
检查区域 ID、数据类型和值格式；
部分属性只允许特定车辆状态下写入；
APVP 的 RX/只读信号模拟写入仅用于明确的调试场景；
不要尝试随机值或把另一个车型的值域直接套用。

4. 启动、闪退、卡顿和界面异常¶

4.1 更新后打开几秒就闪退¶

暂停会在启动时自动运行的自动化和脚本；
如果无法进入界面，先保留“上次日志”；
使用系统诊断日志选择“闪退”，补充升级前后版本和发生时间；
若清除数据能恢复，说明本地配置或缓存可能参与问题，但清除前应先备份；
不要只提供“闪退”两个字，尽量说明是否在自动化运行、音乐播放、投屏恢复或深睡唤醒后发生。

4.2 界面明显卡顿¶

关闭系统进程悬浮窗、深度 Debug 和高频日志；
检查是否同时打开大量属性监控、图表、仪表信息卡或小窗；
检查自动化是否毫秒级重复触发；
暂停高频 CAPI/AIDL 属性订阅或复杂显示公式做对比；
在系统进程页观察 CPU 和内存排行；
上传系统诊断并选择“严重卡顿”。

4.3 白天模式文字看不清或按钮异常¶

切换主题后重新进入页面；
暂时移除自定义皮肤，确认是否由皮肤造成；
使用“恢复初始皮肤”或导入已知正常皮肤；
截图时同时说明白天/夜间模式和当前皮肤名称。

4.4 配置修改后界面没有更新¶

返回上一级再重新进入；
检查是否点击了保存；
车型云端配置变更后执行一次刷新或清除缓存；
设备覆写删除后若仍保留旧效果，先同步云端配置并重启相关服务；
不要直接清除应用数据，先上传日志确认客户端收到的配置版本。

5. 自动化问题¶

5.1 规则不触发¶

自动化引擎是否运行；
规则是否启用；
触发器是否使用正确属性、区域和值；
是否仍在冷却时间；
是否设置了过长保持时间；
属性是否只是首次加载，没有发生真实变化；
执行日志中是否有触发记录。

5.2 触发了但动作没执行¶

检查主条件和分支条件；
检查条件判定延迟；
检查动作链前面是否中断；
单独手动执行失败动作；
查看执行日志的具体失败原因。

5.3 规则反复执行¶

增加冷却、防抖或保持时间；
使用“仅边界触发”；
检查多个触发器是否同时命中；
检查规则之间是否互相触发；
检查 IF IF 分支是否让多个分支同时执行。

详细说明见 EVCC 自动化使用手册。

6. 公式、变量和 Lua¶

6.1 公式显示原值或报错¶

检查括号、函数名和参数数量；
固定文字必须放在英文引号中；
时间卡片的格式字段是日期格式，不是数学公式；
检查值映射是否覆盖了公式结果；
$prop(...) 必须使用正确属性 ID 和区域；
music_state 是文本，不要在数值公式中比较。

6.2 变量没有更新¶

确认变量名大小写一致；
自定义变量需要先由动作或 Lua 创建；
bpm 和 music_state 是只读变量，不能手动覆盖；
无音乐或 BPM 未匹配时，bpm 为 0；
检查自动化或 Lua 是否仍在运行。

6.3 Lua 脚本没有反应¶

检查脚本是否已运行；
手动触发回调需要脚本保持运行；
查看脚本日志中的错误；
确认脚本声明的权限和依赖服务；
在 Web IDE 中先用模拟数据测试；
不要同时开启多个会争抢同一属性或服务的脚本。

7. 音乐桥接¶

7.1 没有歌曲信息或控制无效¶

确认音乐桥接已打开；
车机重启后等待约一分钟让媒体服务就绪；
确认目标音乐 App 出现在媒体会话来源中；
一般保持推荐注册源，不要随意切换高级注册源；
领克车型出现授权异常时，检查 Frida 部署和开关；
切换“全局媒体键控制”只用于兼容性对比；
上传日志时说明音乐 App 名称、播放/暂停状态和具体失效按钮。

7.2 封面或歌词异常¶

检查目标 App 是否实际提供封面或歌词；
暂时开启“不获取高清封面”做对比；
检查歌词时间偏移；
手机互联音乐只有系统上报歌词时才可显示；
桌面歌词不显示时检查目标屏幕、位置、透明度和播放状态。

8. 投屏、悬浮窗和状态栏¶

8.1 悬浮窗不显示¶

授予“显示在其他应用上方”权限；
检查服务卡片开关；
检查透明度、大小和位置；
多屏车型确认目标显示屏；
重启相关服务或 EVCC。

8.2 HUD/小窗投屏画面错误¶

检查目标 Activity 是否可启动；
调整分辨率、缩放、裁切、旋转和偏移；
修改后点击更新或重新启动投屏；
导入他人参数时确认车型一致；
画面黑屏时检查目标应用、显示器和虚拟屏是否仍存在。

8.3 仪表投屏连接失败¶

确认车型和硬件支持；
检查 CP 节点网络；
默认场景可先测试 198.18.44.2 是否可达；
切换编码模式或降低刷新率排查卡顿与花屏；
重启后不恢复时检查自启和源 Activity。

9. 内容商店¶

9.1 分享码找不到内容¶

检查分享码是否完整；
确认内容未被上传者删除；
检查网络；
让上传者在“我的上传”中重新复制分享码。

9.2 下载后配置异常¶

停用刚导入的规则或脚本；
恢复之前保存的模板或备份；
配置包只重新应用确实需要的项目；
使用“清除缓存”后重启 EVCC；
上传日志并提供内容名称和分享码。

详细说明见 EVCC 内容商店与分享手册。

10. EVCC Mini¶

10.1 Mini 入口不显示¶

确认 EVCC Mini 独立 APK 已安装；
主 EVCC 和 Mini 建议使用同一次发布的配套版本；
重新进入主 EVCC；
仍不显示时重启 EVCC 或车机。

10.2 Mini 页面没有数据¶

主 EVCC 必须保持可用并完成激活；
Mini 需要处于试用或已激活状态；
检查主 EVCC 的属性源、自动化和音乐桥接；
音乐页无内容时先确认音乐桥接有真实播放状态；
更新后出现不兼容提示时同时更新两个 APK。

10.3 应用菜单虚拟屏异常¶

先关闭当前虚拟屏页再重新打开；
调低单 App DPI；
尝试直开或全屏开启模式；
某些 App 不支持虚拟显示，应改用其他启动方式；
主 EVCC 的 RootService 必须正常。

详细说明见 EVCC Mini 使用手册。

11. MIBO 联动¶

11.1 一直未就绪¶

EVCC 和 MIBO 两端连接方向必须一致；
新安装推荐使用“MIBO 主动连接”；
EVCC 主动连接时检查 MIBO 地址并重新扫描；
MIBO 主动连接时尝试“重启 GATT 服务”；
确认 Main/Recovery 固件与当前 EVCC 兼容；
复制 MIBO 详细设置中的诊断信息。

11.2 数据、页面或资源不更新¶

页面目录和设置通过 Main 连接同步；
TF 资源文件需要通过 Recovery Wi-Fi 或 TF 卡管理；
离线时 EVCC 只显示最近一次缓存；
数据配置异常可先导出，再使用“恢复默认”；
更换硬件类型后检查当前页面和数据配置是否属于正确设备类型。

详细说明见 EVCC 与 MIBO 联动手册。

12. 备份、缓存和清除数据¶

操作	会保留什么	适合场景
清除缓存	保留用户配置	云端配置、商店缓存或临时状态异常
备份全部配置	生成用户配置备份	更新、重装、换机前
还原全部配置	恢复备份中的用户配置	重装或配置损坏后
清除应用数据	不保留本机配置和登录状态	最后的恢复手段

清除应用数据前必须先确认备份可用。包含网络密码、远程凭据或 MIBO Recovery 设置的备份不要公开分享。

13. 如何上传有效日志¶

13.1 当前日志与上次日志¶

问题仍在当前运行中：上传当前日志；
EVCC 刚刚闪退或重启：重新打开后上传上次日志；
日志编号、设备 ID、发生时间和复现步骤应一起提供。

13.2 系统诊断日志¶

适用于：

EVCC 或系统持续闪退；
黑屏、SystemUI 重启；
严重卡顿或系统无响应；
深睡唤醒后异常；
普通应用日志中没有原因。

选择最接近的故障类型，并写明：

大约发生时间；
升级前后版本；
当时运行的自动化、脚本、投屏和音乐功能；
是否重启、清缓存或清数据后恢复。

14. 联系管理员前准备的信息¶

设备 ID；
车型和系统版本；
EVCC 与 Mini 版本；
问题发生时间；
可重复的操作步骤；
完整提示文字或截图；
日志编号；
最近是否导入配置、规则、脚本或皮肤；
最近是否修改自动化、系统设置或车辆属性。

其他功能的完整操作说明见 EVCC 用户手册。