Flask-RESTful中add_resource如何接收含列表的多GET请求参数？

别担心，咱们一步步理清这个问题，你之前逆向分析没成功大概率是混淆了路径参数和查询参数的区别，先从路由配置说起：

1. 正确配置add_resource路由 #

你的请求示例https://localhost:5000/item?analysis=true&class=A&class=B里，analysis和class都是查询参数（?后面的部分），不是URL路径的一部分。所以add_resource不需要加<whatever-comes-here>这种路径参数占位符，直接把路由设为/item即可：

from flask import Flask
from flask_restful import Api, Resource

app = Flask(__name__)
api = Api(app)

class Item(Resource):
    # 后面实现get方法
    pass

# 正确配置：路径就是/item，查询参数不需要写在路由里
api.add_resource(Item, '/item')

if __name__ == '__main__':
    app.run(debug=True)

2. 在get()方法中解析参数 #

Flask提供了request.args来获取查询参数，针对布尔型和列表型参数，有不同的处理方式：

布尔型参数analysis #

直接用type=bool要注意：Flask会把任何非空字符串都解析为True（比如analysis=false也会被转成True，因为字符串"false"非空）。所以更严谨的做法是自定义解析逻辑：

列表型参数class #

用request.args.getlist('class')就能获取所有同名的class参数，返回一个列表。

完整的get()方法示例：

from flask import request

class Item(Resource):
    def get(self):
        # 解析布尔参数：严格判断是否为'true'（不区分大小写）
        analysis = request.args.get('analysis', default=False, type=lambda x: x.lower() == 'true')
        
        # 解析列表参数：获取所有class参数，返回空列表如果没有
        classes = request.args.getlist('class')
        
        # 这里写你的业务逻辑，比如返回解析后的参数
        return {
            'analysis_enabled': analysis,
            'selected_classes': classes
        }

测试一下你的请求http://localhost:5000/item?analysis=true&class=A&class=B，会返回：

{
  "analysis_enabled": true,
  "selected_classes": ["A", "B"]
}

3. GET请求传递列表的更佳方式 #

REST API中传递列表常用这几种方式，各有优劣：

• 同名多参数（推荐）：就是你现在用的?class=A&class=B，这是HTTP标准支持的方式，后端用getlist直接解析，直观且兼容性最好，大部分API都采用这种方式。
• 逗号分隔字符串：比如?class=A,B,C，后端需要手动拆分：classes = request.args.get('class', '').split(',')，适合短列表，但要注意处理空值（比如参数为空时会得到['']）。
• 数组格式（不推荐）：有些前端框架会用?class[]=A&class[]=B，后端需要用request.args.getlist('class[]')解析，但这种不是HTTP标准格式，兼容性较差，除非前端框架默认生成这种格式，否则不建议使用。

综上，同名多参数是REST API传递列表的最佳实践，既能保证兼容性，又方便后端解析。

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