解决Django Channels报错：'tuple' object has no attribute 'decode'

问题重现 #

按照Django Channels教程执行以下测试代码时触发报错：

$ python3 manage.py shell
>>> import channels.layers
>>> channel_layer = channels.layers.get_channel_layer()
>>> from asgiref.sync import async_to_sync
>>> async_to_sync(channel_layer.send)('test_channel', {'type': 'hello'})

报错信息：AttributeError: 'tuple' object has no attribute 'decode'

环境版本：

• Ubuntu 20.04LTS
• Python 3.8.10
• Django 4.1.3
• Channels 4.0.0
• Channels-Redis 4.0.0
• Daphne 4.0.0
• Asgiref 3.5.2

原因分析 #

该报错源于asgiref 3.5.2与channels-redis 4.0.0的版本兼容性问题：asgiref 3.5.2中部分方法返回值为tuple类型，而channels-redis 4.0.0仍尝试对其调用decode()方法（仅适用于bytes/str类型），从而触发属性错误。

解决方案 #

1. 升级asgiref版本 #

执行以下命令将asgiref升级到3.6.0及以上版本：

pip install --upgrade asgiref>=3.6.0

Channels 4.x官方要求asgiref>=3.5.0，但3.6.0及以上版本修复了该兼容性问题。

2. 验证Redis通道层配置 #

确保settings.py中的CHANNEL_LAYERS配置正确，示例：

CHANNEL_LAYERS = {
    "default": {
        "BACKEND": "channels_redis.core.RedisChannelLayer",
        "CONFIG": {
            "hosts": [("127.0.0.1", 6379)],
        },
    },
}

同时确认Redis服务处于运行状态。

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