# 连接器接口常见问题总结归纳

来源快照：`result_data_new_260518.json`

- 来源 ID：`1235859844279115782`
- 模块：低代码平台e-builder
- 目录：常见问答 - 动作流
- space ID：`1157961794811633670`
- 原文链接：未提供
- 产品基线：未提供

## 正文

#### **问题1：HTTP状态码返回404 接口地址错误**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235880851122569229&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

1、确认下连接信息

2、确认下请求地址是否正确

备注：地址都使用复制不要手动输入，容易出现大小写、漏字母等问题

#### **问题2：HTTP状态码返回415 请求类型不对**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235881040130899969&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

1、查看 API 文档，明确该接口接受的 Content-Type：application/json、application/x-www-form-urlencoded、multipart/form-data（上传文件）、text/plain、application/xml

2、常见问题：

a、缺少 Content-Type 头：发送了数据但未声明格式。

b、Content-Type 值错误 / 拼写错误：

c、如：applicaton/json（少一个 i）、json（不完整）。

d、如：服务器要 application/json，你却发 text/plain 或 application/x-www-form-urlencoded。

声明与实际内容不符：

e、头写 application/json，但 body 是纯文本、XML 或表单数据。

f、字符集错误：如 charset=utf8 而非 charset=utf-8，空 / 格式错误的请求体：服务器严格校验时也会返回 415。

#### **问题3：域名无法解析 Name or service not known**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235882349965492227&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

1、服务器域名无法解析，到oa服务器上ping一下域名，如果请求不通找运维看下网络

如：ping sms.cnooc

2、常见问题：

a、域名写错

b、有多个连接信息实际使用的时候选择错误

c、未配置域名解析（找运维）

#### **问题4：HTTP状态码返回405**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235882629265022984&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

请求方式：确认下接口是post 、get、put…具体的请求方式

#### **问题5：HTTP状态码返回500 对方接口报错（Internal Server Error）**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235882800870776835&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

对方接口报错，联系接口提供方确认问题

#### **问题6：HTTP状态码返回204 无响应内容**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235884278308544512&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

204接口本身没有任何返回信息，这种在2026基线已经支持，老基线看到204可以配置使用异常跳过

备注：204经常发生于patch请求推送数据并不关心返回，接口本身没有返回

#### **问题7：HTTP状态码返回400 参数不对**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235884450251046918&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

1、参数中有字段写错，类型不对

2、oa中JSON属性和节点选择错误

3、错误的设置了“开启明细”

4、字段名写错、少传、多传

5、类型不匹配：接口要数字，你传了字符串

6、参数格式非法：日期、手机号、ID 格式不对

7、JSON 少逗号、多括号、引号不配对，明明是 JSON，却发成表单格式

8、空请求体但接口必须要内容

9、Content-Type 乱填或缺失

10、URL 本身非法

11、特殊字符没转义

12、参数超长

13、后端校验严格

14、字段长度超限制

15、必传字段为空

16、枚举值不在允许范围内

#### **问题8：参数偶发丢失**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235884570367524868&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

现象：参数第一次传参的时候某个参数或者整体请求参数没有，再次请求正常

处理方式：

250401基线

weaver-esb-server-1.57.0-hotfix15

250501基线

weaver-esb-server-1.58.0-hotfix8

250601基线

weaver-esb-server-1.59.0-hotfix13

250701基线

weaver-esb-server-1.60.0-hotfix9

250801基线

weaver-esb-server-1.61.0-hotfix5

250901基线

weaver-esb-server-1.62.0-hotfix1

#### **问题9：HTTP状态码返回401、403 没登录 / 登录过期 / 凭证无效**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235884742404882435&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

1、401 ： 未授权

2、403：登录了，但没权限访问这个接口

3、常见原因：

a、没带 Token / 没带 Cookie

b、Token 过期、失效、被注销

c、Token 写错、少复制一段、格式不对，比如前面少了 Bearer

d、请求头里 Authorization 拼写错误

e、前后端约定的认证方式不匹配

#### **问题10：connect timed out 连接超时**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235884879696240642&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

1、客户公司内部网络隔离（找客户公司运维看下网络，在postman中赋值curl命令粘贴到oa服务器中执行，如果毫无反应就是网络不通，找运维确认下  网络问题）

如：curl [http://api.qixin.com](http://api.qixin.com)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1236225449200074754&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2、环境ip、或者域名拼写错误（地址尽量复制）

3、如果网络本来跳转多就是比较慢，到连接器->连接->调整连接超时时间（单位是：秒）

#### **问题11：Read timed out 响应超时**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235885025713340419&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

1、客户公司和接口服务网络慢（找客户公司运维看下网络）

2、如果网络本来跳转多就是比较慢（到连接器->连接->调整响应超时时间（单位是：秒））

3、如果是偶发的：

a、微服务和组合是在nacos中：

找到weaver-esb-server-service这个配置文件 添加

[esb.monitor.config.host](http://esb.monitor.config.host)-http-white-list=[openapi-fat3.fenbeijinfu.com](http://openapi-fat3.fenbeijinfu.com)（替换目标接口域名，不包含http、https）

b、单体路径E10项目路径 +/webapps/ROOT/WEB-INF/classes/weaver/config/config-center

单体要重启

#### **问题12：Connection reset 连接重置**

![](https://weapp.eteams.cn/papi/file/preview?fileId=1235885171876446211&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**处理方案：**

1、微服务和组合是在nacos中：

找到weaver-esb-server-service这个配置文件 添加

[esb.monitor.config.host](http://esb.monitor.config.host)-http-white-list=[openapi-fat3.fenbeijinfu.com](http://openapi-fat3.fenbeijinfu.com)（替换目标接口域名，不包含http、https）

2、单体路径E10项目路径 +/webapps/ROOT/WEB-INF/classes/weaver/config/config-center

单体要重启

#### **问题13：新建连接器选择不到**

客户新建的连接器，新建接口，动作流中找不到新建的连接器接口

**处理方案：**

检查下客户是否接口没有发布

#### **问题14：json属性和节点问题**

客户新建连接器接口参数的时候没有用参数自动解析，手动添加，json节点不知道配置节点或者属性

![](https://weapp.eteams.cn/papi/file/preview?fileId=1236227721103556611&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

参数设置中 json类型参数的数据类型有属性和节点区分

**属性** ： 会将节点的下层转换成json字符串形式传递

**节点** ： 节点的下层将以json有层级的格式传递

以上图为例：

**属性** ：

{  
    "data": "{\"id\":1,\"name\":\"李华\"}"  
}

**节点** ：

{

    "data": {

        "id": 1,

        "name": "李华"

        }

}

**处理方案：**

客户或者项目不使用参数批量解析经常把json的属性或者节点弄错,让提问题者给出json示例，使用解析工具自动解析

#### **问题15：配置响应参数但是没有接收到响应**

配置了响应参数但是报文中没有响应参数相信信息

**处理方案：**

1、检查下是否配置了响应

2、看下是否误开启了或者未开启“开启明细”

3、接口返回不固定可能请求参数不同返回信息不同导致，这个需要连接器接口提供方返回统一接口数据

#### **问题16：连接器不知道如何删除**

连接器配置后想删除找不到删除按钮

**处理方案：**

需要将连接器下的连接、接口都删除后才能删除连接器

#### **问题17：连接器中附件相关操作**

连接器参数传参中需要传附件相关信息，字节流 文件流函数选择错误

**处理方案：**

1、确认下传输的是文件流还是字节流（使用对应的函数设置参数）

字节流：ATTACHMENTTOBYTE () --二进制字节数组

文件流：ATTACHMENTTOFILE () ---文件地址信息

2、检查下请求数据格式类型是否正确

3、其他三方和OA之间相关附件传递格式可查看文档：

[https://www.e-cology.com.cn/sp/ebdfpage/dataShare/freepass/t7akvdnf84/1236226316674809875](https://www.e-cology.com.cn/sp/ebdfpage/dataShare/freepass/t7akvdnf84/1236226316674809875)

#### **问题18：连接器数组赋值**

连接器接口中需要参数数组类型的参数，经常在动作流中看连接器请求报文，明明设置了参数但是连接器中没有配置的参数

**处理方案：**

1、数组传值固定的数组中就传固定的一条数据，数组节点上要填写默认值“1”

2、多条数据的时候动态赋值的时候要在上下文中选择“list”类型的数据赋值，然后配合“依据值”给数组中的下级参数赋值

#### **问题19：连接器请求参数、响应参数-“开启明细”**

设置请求和响应参数的时候“开启明细”按钮不按照实际情况，开启或者未开启“**开启明细** ”开关

**处理方案：**

1、当且仅当请求参数或者响应参数整体被“[]”中括号包含的时候才开启，并不是只要结构中有“[]”就开启

正确示例：开启明细

[

{

"a":"参数值",

   "b":"参数值"

  }

]

错误示例：不应该开启明细

{

 "a":"参数值",

    "b":"参数值"

[

{

"a":"参数值",

            "b":"参数值"

             }

]

}

#### **问题20：连接器请求参数、响应参数格式中最外围是[]时，需要怎么配置**

[

{

"image": "sfasq35sadvsvqwr5q...",

"image_type": "BASE64",

"face_type": "LIVE",

"quality_control": "LOW",

"liveness_control": "HIGH"

},

{

"image": "sfasq35sadvsvqwr5q...",

"image_type": "BASE64",

"face_type": "IDCARD",

"quality_control": "LOW",

"liveness_control": "HIGH"

}

]

**处理方案：** 请求参数和响应参数开启下最上级的明细开关，然后将参数复制到右侧图标的输入框中可一键生成

![](https://weapp.eteams.cn/papi/file/preview?fileId=1247435541378203649&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)
