如何在Oracle APEX REST数据源中传递form-data请求体？

核心原因 #

1. 请求头配置错误：APEX REST数据源默认不会自动设置multipart/form-data请求头，后端无法识别请求体格式；若手动指定完整的Content-Type（含边界符），反而可能和APEX自动生成的边界符冲突。
2. 参数类型误用：将form-data字段配置成了查询参数、JSON请求体参数，而非专门的「表单数据」类型，导致参数没有被放入请求体中。
3. 文件上传处理不当：涉及文件时，未正确指定参数为文件类型，导致文件内容未被正确编码进form-data请求体。

正确传递form-data的步骤 #

1. 配置请求头 #

在REST数据源的「请求头」设置中，添加Content-Type头，但不要手动填写具体值。APEX会根据你添加的表单数据自动生成符合规范的multipart/form-data; boundary=xxx请求头，避免边界符不匹配问题。

2. 添加表单数据参数 #

• 进入REST数据源的「参数」页面，点击「添加参数」。
• 参数类型选择表单数据（Form Data）。
• 填写与后端API完全一致的参数名称，参数来源选「静态值」（固定值）或「项」（从APEX页面项动态取值）。
• 若需上传文件：参数类型仍选「表单数据」，在「值」的选项中选择「文件」，并关联对应的APEX文件上传项（例如P1_DOCUMENT）。

3. 验证与调试 #

配置完成后，使用APEX内置的「测试」功能发送请求，检查后端是否接收到参数。如果仍失败：

• 启用REST数据源的「日志请求」功能，查看实际发送的请求头和请求体。
• 对比Postman中的请求内容（可在Postman的「代码」标签中复制原始请求），重点检查参数名称、请求头的边界符、参数编码是否一致。

4. 特殊场景处理 #

• 若后端需要嵌套结构的form-data：APEX不支持直接嵌套，可将嵌套内容序列化为JSON字符串，作为单个表单字段的值传递，后端再解析该JSON。
• 字符编码问题：确保APEX页面和后端API都使用UTF-8编码，APEX默认已配置，无需额外调整。

内容的提问来源于stack exchange，提问作者Thish