Flask使用Connexion时GET请求如何接收数组参数
单ID接口扩展为支持多ID数组的实现方案
该需求完全可实现,可通过调整OpenAPI参数定义、优化SQL查询逻辑完成,完美适配你当前Connexion+Flask的技术栈。
核心实现逻辑
Connexion会严格按照OpenAPI定义的参数规则,自动完成类型转换、参数校验,并把处理后的参数直接注入到后端接口函数中,不需要像原生Flask那样手动解析请求参数。只要在OpenAPI配置里把ID参数定义为数组类型,后端接收到的就已经是格式合法的Python整数列表。
第一步:调整OpenAPI接口配置
结合你前端表格批量选中ID的使用场景,不推荐沿用原路径参数传值的方式(路径塞数组会导致URL过长,前端构造请求成本高),推荐把ID参数调整为query类型的数组参数,对应YAML配置修改如下:
# 去掉原路径末尾的{drug_product_id}路径参数占位 /read/maa_valid_product_id: get: operationId: registrations.read_maa_valid_product_id tags: - Marketing Applications summary: 批量查询指定药品ID对应的非失效、有效状态的上市许可记录 description: 批量查询指定药品ID对应的非失效、有效状态的上市许可记录 parameters: # 删除原路径下的单个drug_product_id参数定义,替换为query类型的数组参数 - in: query name: drug_product_ids required: true schema: type: array items: type: integer # 匹配前端最常用的传参格式:?drug_product_ids=1&drug_product_ids=2&drug_product_ids=3 style: form explode: true description: 待查询的药品产品ID数组 - in: query name: length required: false schema: type: integer description: 分页返回的单页数据长度 - in: query name: offset required: false schema: type: integer description: 分页偏移量 responses: '200': description: 成功返回对应药品的有效上市许可记录列表 content: application/json: schema: type: array items: $ref: '#/components/schemas/marketing_application'
可选兼容方案:如果前端习惯用逗号分隔的字符串形式传ID(比如
?drug_product_ids=1,2,3),只需要把参数配置里的style改为simple、explode改为false,Connexion会自动把逗号分隔的字符串解析为整数列表,不需要手动写split逻辑。
第二步:调整后端接口代码
你现有代码只需要改动2个核心位置,其余分页、结果序列化逻辑完全可以复用:
- 修改函数签名,替换原单个ID的入参为数组入参:
def read_maa_valid_product_id(drug_product_ids, length=0, offset=0): - 修改SQL查询的过滤条件,把原单ID等值判断改为IN匹配,适配数组入参:
- 把SQL语句中原有的
AND A.DRUG_PRODUCT_ID = :id,替换为AND A.DRUG_PRODUCT_ID IN :id_list - 把原来执行查询时的参数绑定字典,改为传入数组:
cursor_ariel.execute(sql, {"id_list": drug_product_ids})
- 把SQL语句中原有的
注意:你当前使用的Oracle数据库驱动(cx_Oracle/oracledb)原生支持直接把Python列表作为IN子句的绑定值,不需要手动拼接SQL字符串,能完全避免SQL注入风险。
常见注意事项
- 不要额外增加单ID/数组入参的兼容判断逻辑,前端哪怕只传1个ID,也以单元素数组的形式传入即可,兼容成本极低
- 不要手动把ID列表拼接成字符串嵌入SQL语句,容易触发SQL注入,全部使用驱动内置的参数绑定能力传值
- 原代码中基于fetchall结果的offset、length分页逻辑,对批量查询的返回结果完全生效,不需要做额外修改
内容的提问来源于stack exchange,提问作者smackenzie
相关产品推荐
相关产品推荐

