EVCC项目中KIA车辆API连接问题的分析与解决

问题背景

在EVCC开源项目中，用户报告了与KIA电动汽车API连接失败的问题。该问题表现为通过EVCC命令行工具获取车辆状态信息时出现连接超时或认证失败错误，而同时KIA官方手机应用却能正常工作。

错误现象分析

用户遇到的主要错误包括以下几种情况：

1. DNS解析超时：dial tcp: lookup prd.eu-ccapi.kia.com: i/o timeout
2. 认证失败：login failed: unexpected status: 400 (Bad Request): Invalid values (4003)
3. 间歇性连接问题：有时能成功获取数据，有时失败

根本原因

经过深入分析，发现问题主要由以下因素导致：

1. DNS64配置问题：在某些网络环境中启用了DNS64转换，导致返回了IPv6地址(64:ff9b::67bb:23ec)，而KIA API服务器可能不完全支持IPv6连接
2. API端点不稳定：KIA的API服务器有时响应缓慢或返回意外状态码
3. 认证流程变更：KIA可能对认证流程进行了细微调整，导致部分请求失败

解决方案

针对上述问题，可以采取以下解决方案：

1. 检查并修复DNS配置

确认本地DNS解析是否返回了正确的IPv4地址。可以通过以下命令检查：

host prd.eu-ccapi.kia.com

如果发现返回了IPv6地址，可以：

• 临时解决方案：在/etc/hosts文件中添加静态解析记录
• 长期解决方案：检查网络中的DNS64配置并适当调整

2. 增加重试机制

由于API服务可能存在间歇性问题，建议在EVCC配置中增加重试参数：

cache: 10m  # 设置合理的缓存时间

3. 验证认证信息

确保配置中的用户名、密码和VIN码完全正确，特别注意：

• 密码中的特殊字符可能需要转义
• VIN码必须与车辆完全匹配

配置建议

以下是经过验证的可靠配置示例：

vehicles:
  - name: EV6
    type: template
    template: kia
    user: [e-mail]
    password: 'your_password'  # 使用单引号包裹密码
    vin: YOUR_VIN_CODE  # 17位车辆识别号
    capacity: 84  # 电池容量(kWh)
    cache: 5m  # 5分钟缓存

技术要点

1. KIA API工作流程：

   • 设备注册
   • OAuth2授权流程
   • 静默登录(silentsignin)
   • 令牌获取与刷新

2. 常见错误处理：

   • 400错误：检查认证信息
   • 超时错误：检查网络连接和DNS
   • 间歇性失败：增加重试逻辑

总结

KIA车辆与EVCC的集成问题通常与网络配置和认证流程相关。通过正确配置DNS、验证认证信息并设置合理的缓存时间，大多数连接问题都可以得到解决。对于企业或复杂网络环境，建议网络管理员检查IPv6相关配置，确保API端点能够被正确解析和访问。

EVCC作为开源电动汽车充电控制项目，与各汽车厂商API的集成可能会随着厂商API的更新而需要调整。遇到类似问题时，建议先检查基础网络连接，再验证认证信息，最后考虑API兼容性问题。