跳到主要内容

常见问题 FAQ

产品与版本​

ApiGo 适合什么场景？​

面向需要把存量业务系统（ERP、CRM、SRM 等）数据安全开放给 AI 智能体或外部系统的企业，覆盖 API 构建、治理、开放、监控全生命周期。

订阅版与企业版的区别？​

订阅版提供平台全部功能与部署包；企业版额外提供源码包授权、专属技术服务、功能培训、定制开发等。详见首页 价格方案。

数据源​

支持哪些数据库？​

18+ 种：MySQL、Oracle、PostgreSQL、SQL Server、TiDB、OceanBase、OpenGauss、TDSQL、StarRocks、Doris、达梦、KingBase，以及 MongoDB、Elasticsearch、Hive、ClickHouse、TDengine、DolphinDB。

数据源连接失败怎么排查？​

  1. 确认网络连通性（跨网段需开通防火墙端口）
  2. 确认数据库账号密码与访问权限
  3. 查看平台日志中的具体驱动错误信息

API 开发​

SQL 模式支持哪些语法？​

标准 SQL + MyBatis 动态标签（<if>、<where>、<foreach> 等），支持动态参数绑定与条件过滤，支持 SELECT / INSERT / UPDATE / DELETE / 存储过程。

如何做接口的 Mock 测试？​

为接口配置 Mock 规则后，通过 /mock/{envCode}/** 路径访问即可返回模拟响应，联调阶段无需真实后端。

编排模式有什么限制？​

编排图（DAG）支持串行、并行、条件分支与数据合并；API 节点可递归调用其他接口，但有最大深度限制以防止循环调用。

调用与认证​

返回 40013 签名验证失败怎么办？​

按 签名认证排查清单 逐项检查，最常见原因是 query 串未纳入签名或请求体被 HTTP 库重新序列化。

返回 40010 时间戳过期？​

检查客户端与服务器时钟同步（NTP）；确认使用毫秒级（13 位）时间戳。

nonce 可以复用吗？​

不可以。网关以 AppKey + SM3(nonce) 做防重放校验，重复 nonce 直接判定为重放。重试时必须重新生成时间戳与 nonce。

平台架构​

配置变更需要重启服务吗？​

不需要。配置写入 MySQL 后同步到 Redis 运行时配置中枢，通过 Pub/Sub 增量通知网关与执行服务，实时生效。

调用日志存在哪里？​

默认存 MySQL，大规模场景可切换 Elasticsearch，由配置决定。

如何水平扩容？​

网关与执行服务无状态（配置来自 Redis + Nacos），可直接水平扩展；Sentinel 规则经 Redis 保持集群一致。

发布与同步​

接口已发布，为什么调用仍返回 40001？​

依次检查：目标环境是否已同步（开发环境快照不会自动同步到测试/生产）、环境是否启用、接口是否上线、网关是否收到路由变更。必要时执行手动对账，详见 配置同步与发布链路。

修改配置后多久生效？​

正常情况下秒级生效：管理端写入 Redis 后通过 Pub/Sub 通知网关。若消息丢失，网关每 5 分钟按版本号对账补偿。流控/熔断为增量更新，路由为整表刷新。

发布快照可以修改吗？​

不可以。快照是不可变的历史版本；修改设计态后需要重新发布生成新修订号。回滚只是把历史快照重新设为当前版本。

AI 与 MCP​

AI 问数能执行写操作吗？​

不能。问数链路强制只读校验，DDL、写语句与多语句会被拦截。需要写入时应通过智能助理的确认卡片或受控工具执行，并留下审计记录。

为什么应用 MCP 里看不到某个接口？​

需同时满足：发布协议包含 MCP、已发布到 prod 并上线、认证方式为 app_key、应用已获接口授权、应用已启用 MCP。任一条件不满足都不会出现在 tools/list 中。

AI 日志里为什么有些 action 显示原始英文？​

界面筛选只覆盖生成、优化、查询等常用动作；智能体相关动作（如 AGENT_TURN、AGENT_CONFIRM）会以原始 action 展示，属于当前 UI 的展示范围限制，不影响数据完整性。

AI 调用失败如何定位？​

在 AI 调用日志中按问题关键词或时间范围筛选，查看 failReason 与耗时；成功率报表按场景聚合，可快速判断是模型、SQL 还是工具调用环节的问题。详见 AI 调用日志。

安全治理​

接口缓存为什么没有生效？​

缓存只对「JSON 响应 + SELECT 查询 + 已关联缓存规则 + 响应体不超限」的接口生效；MCP 与管理端调用不走缓存。规则修改不会主动清除旧缓存，需要等待 TTL 到期。详见 接口缓存。

告警为什么不是实时触发？​

告警由定时任务每 10 分钟扫描一次，且受时间窗口、最小请求数与频率限制；同一日志 24 小时内不会重复告警。需要秒级发现时应使用流控/熔断与外部监控。详见 告警规则与告警记录。

IP 白名单和应用 IP 白名单有什么区别？​

应用凭证的 IP 白名单在认证阶段校验（错误码 40018），对所有授权接口生效；接口级 IP 规则在认证后按规则校验（错误码 40012），可对单个接口设置黑/白名单。详见 IP 访问控制与 WAF。

部署与许可​

License 过期后服务会怎样？​

启动校验失败会直接阻止启动；运行期每日校验失败会记录 L007 并优雅退出（退出码 1）。更新 License 文件后重启服务即可。详见 部署拓扑与 License。

容器部署时 License 状态文件放在哪里？​

必须挂载到持久卷。strict=true 时状态文件不可用会拒绝启动，这是防止删除状态文件绕过时钟回拨检测的设计。

一套 License 可以用于多个服务吗？​

取决于 serviceIds 白名单。非空时只有列表内的服务能通过校验；为空表示不限制。节点数上限仅对 CLUSTER 类型生效。

更多帮助​