使用Authlib+FastAPI对接Mailchimp OAuth2时遇invalid_client错误

基于Authlib和FastAPI构建多认证提供商工厂，其他提供商正常，但对接Mailchimp时，在回调执行token = await oauth_client.authorize_access_token(request)时抛出错误：

authlib.integrations.base_client.errors.OAuthError: invalid_client: client_id parameter missing

已确认client_id=settings.MAILCHIMP_CLIENT_ID配置正确。

相关核心代码片段：
provider_factory.py中Mailchimp注册部分

oauth.register(
    name='mailchimp',
    client_id=settings.MAILCHIMP_CLIENT_ID,
    client_secret=settings.MAILCHIMP_CLIENT_SECRET,
    authorize_url='https://login.mailchimp.com/oauth2/authorize',
    access_token_url='https://login.mailchimp.com/oauth2/token',
    api_base_url='https://login.mailchimp.com/oauth2/',
)

回调函数核心逻辑

oauth_client = ProviderFactory.get_oauth_client(provider)
token = await oauth_client.authorize_access_token(request)

1. 指定Token端点的认证方式（关键修复） #

Mailchimp的OAuth2 token接口要求客户端ID和密钥通过HTTP Basic认证传递，而非默认的表单参数。Authlib默认可能使用client_secret_post方式，需要显式指定认证方法：

修改Mailchimp的注册配置，添加client_kwargs：

oauth.register(
    name='mailchimp',
    client_id=settings.MAILCHIMP_CLIENT_ID,
    client_secret=settings.MAILCHIMP_CLIENT_SECRET,
    authorize_url='https://login.mailchimp.com/oauth2/authorize',
    access_token_url='https://login.mailchimp.com/oauth2/token',
    api_base_url='https://login.mailchimp.com/oauth2/',
    client_kwargs={
        'token_endpoint_auth_method': 'client_secret_basic'
    }
)

这个配置会让Authlib自动将client_id和client_secret编码为Basic Auth头，符合Mailchimp的要求。

2. 验证配置值是否真正加载 #

虽然你确认配置正确，但可以临时添加日志或打印，确保settings.MAILCHIMP_CLIENT_ID和settings.MAILCHIMP_CLIENT_SECRET不是空值：

# 在ProviderFactory的oauth.register前添加
print(f"Mailchimp Client ID: {settings.MAILCHIMP_CLIENT_ID}")
print(f"Mailchimp Client Secret: {settings.MAILCHIMP_CLIENT_SECRET}")

如果输出为空，检查配置加载逻辑（比如.env文件是否正确读取、环境变量是否设置）。

3. 确认redirect_uri完全匹配 #

Mailchimp控制台配置的redirect_uri需要和request.url_for('callback', provider=provider)生成的地址完全一致，包括http/https、域名、路径，任何细微差异都会导致认证失败。

4. 手动调试Token请求（可选） #

可以临时跳过Authlib的封装，手动发送请求到Mailchimp的token端点，验证参数是否正确：

import base64
import httpx

async def test_token_request(code, redirect_uri):
    auth_str = f"{settings.MAILCHIMP_CLIENT_ID}:{settings.MAILCHIMP_CLIENT_SECRET}"
    auth_bytes = auth_str.encode('utf-8')
    auth_base64 = base64.b64encode(auth_bytes).decode('utf-8')
    
    async with httpx.AsyncClient() as client:
        response = await client.post(
            'https://login.mailchimp.com/oauth2/token',
            headers={
                'Authorization': f'Basic {auth_base64}',
                'Content-Type': 'application/x-www-form-urlencoded'
            },
            data={
                'grant_type': 'authorization_code',
                'code': code,
                'redirect_uri': redirect_uri
            }
        )
        print(response.status_code)
        print(response.json())

在回调函数中先调用这个测试函数，如果能成功获取token，说明问题确实出在Authlib的配置上。

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