aiohttp配合dataclass时如何自动转换参数为合法请求类型

直接写一个通用的转换函数即可，不需要在每次发请求时手动给每个字段写判断逻辑，函数会自动遍历dataclass的所有字段，按你指定的规则统一做值转换。

核心逻辑说明 #

所有转换规则集中在一处维护，不用散落在各个业务代码里：

• 布尔值True转成字符串'True'，False转成字符串'False'
• 空值None转成空字符串''
• 其他本身就符合aiohttp参数要求的int、float、str类型，直接转成可被aiohttp识别的字符串格式即可

可直接复用的实现 #

from dataclasses import fields, is_dataclass

def _convert_single_value(val):
    # 集中维护所有转换规则
    if val is None:
        return ""
    if val is True:
        return "True"
    if val is False:
        return "False"
    return str(val)

def convert(dataclass_instance) -> dict:
    # 简单入参校验，避免传错类型
    if not is_dataclass(dataclass_instance):
        raise TypeError("convert函数仅支持dataclass实例输入")
    # 遍历所有dataclass字段，自动组装成aiohttp支持的参数字典
    return {
        field.name: _convert_single_value(getattr(dataclass_instance, field.name))
        for field in fields(dataclass_instance)
    }

适配你的示例代码 #

把上面的函数集成进去之后，完整可运行的代码如下，全程不需要手动写字段转换逻辑：

import asyncio
import aiohttp
from typing import Optional
from dataclasses import dataclass, fields, is_dataclass

@dataclass
class Params:
    a: bool
    b: str
    c: Optional[float] = None

def _convert_single_value(val):
    if val is None:
        return ""
    if val is True:
        return "True"
    if val is False:
        return "False"
    return str(val)

def convert(dataclass_instance) -> dict:
    if not is_dataclass(dataclass_instance):
        raise TypeError("convert函数仅支持dataclass实例输入")
    return {
        field.name: _convert_single_value(getattr(dataclass_instance, field.name))
        for field in fields(dataclass_instance)
    }

async def main():
    params = Params(
        a=True,
        b='b',
        c=None
    )
    async with aiohttp.ClientSession() as session:
        # 直接将dataclass实例传入convert即可，无需手动处理每个值
        async with session.get('http://www.example.com', params=convert(params)) as r:
            print(await r.text())

asyncio.run(main())

实际效果 #

上面的示例里，params实例经过convert转换后生成的字典为：
{'a': 'True', 'b': 'b', 'c': ''}
完全匹配你要求的转换规则，而且全字符串值的字典是aiohttp完全兼容的params参数格式，不会触发类型不匹配的报错。

补充说明 #

• 这套实现不需要依赖dataclasses-json这类第三方包，仅靠Python自带的dataclass模块就能运行，减少额外依赖
• 后续如果需要调整转换规则（比如要把布尔值改成小写'true'/'false'），只需要修改_convert_single_value里的对应逻辑就行，所有调用convert的地方会自动同步生效，不用逐处改业务代码
• 如果后续dataclass字段有新增或者删除，convert函数会自动适配字段变化，不需要修改转换逻辑本身

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