Question 1

如何修复 Synapse 1.153.0 在 Ubuntu 24.04 上启动失败并提示 'needs attrs!=21.1.0,>=26.1.0, but got attrs==23.2.0' 的问题？

Accepted Answer

这是由于 Synapse 1.153.0 中意外提高了 `attrs` 的最低版本要求所导致的，该问题已在 Synapse 1.154.0 中回退。

通过升级 Debian/Ubuntu 软件包来修复：

```bash
sudo apt update
sudo apt install matrix-synapse-py3
sudo systemctl restart matrix-synapse
```

如果 `packages.matrix.org` 尚未提供 1.154.0，作为临时解决方案，可以降级到之前可正常工作的版本：

```bash
sudo apt install matrix-synapse-py3=1.152.1+noble1
sudo systemctl restart matrix-synapse
```

除非您了解软件包环境，否则请避免使用 pip 手动强制指定 `attrs` 版本，因为官方的修复方法是升级到 Synapse 1.154.0 或更高版本。

Question 2

为什么启用sticky events后，Synapse mautrix bridge加密会失败并出现'UnboundLocalError: cannot access local variable now_token'？

Accepted Answer

这是 Synapse v1.150.0 至 v1.152.1 版本中的一个已知错误，其中粘性事件会在同步处理过程中引发 Python 未绑定局部变量错误。该错误会导致 mautrix-signal/WhatsApp 等桥接器无法接收解密密钥。临时解决方案：将 Synapse 降级至 v1.149.0 版本。该问题的永久修复正在相关 GitHub Issue #19409 中跟进。

Question 3

为什么当 pos offset 保持不变时，Sliding Sync 不会发送新请求的 required_state 事件？

Accepted Answer

Synapse 1.136.0（及更早版本）中存在已知错误：对 required_state 的更改会被忽略，直到有其他房间活动发生。解决方法：在房间中触发任意事件（例如发送消息）以强制同步。永久修复正在通过 PR #19792 重新引入。

Question 4

当在未加密房间中发送消息时，如何修复 Synapse 错误“400 - 1 validation error for Mentions”？

Accepted Answer

这影响与 Element Web 1.12.8/1.12.12 搭配使用的 Synapse 1.147.1。即使没有人被提及，Element Web 也会发送 `m.mentions: {}`。Synapse 将事件内容表示为 `immutabledict`，而 Pydantic v2 在验证 `Mentions` 模型时会拒绝 `immutabledict({})`。加密房间不受影响，因为 Synapse 看不到明文内容。

在 Pydantic 验证前将类似映射的输入转换为 `dict`，从而在 Synapse 中修复：

from typing import Any, List
from pydantic import BaseModel, Field, model_validator

class Mentions(BaseModel):
    user_ids: List[str] = Field(default_factory=list)
    room: bool = False

@model_validator(mode='before')
    @classmethod
    def coerce_immutabledict(cls, v: Any) -> Any:
        if hasattr(v, 'items') and not isinstance(v, dict):
            return dict(v)
        return v

将此补丁应用到你的 Synapse 软件包或 Docker 镜像，重新构建/重新部署，并重启 Synapse。如果可用，请升级到包含问题 #19689 修复的官方 Synapse 版本。临时解决方法：使用加密房间，其中消息内容会在 Synapse 验证前被加密。

Question 5

如何防止 Synapse 的密码重置 /requestToken 流程中的电子邮件账户枚举？

Accepted Answer

在 `homeserver.yaml` 中设置 `request_token_inhibit_3pid_errors: true`，然后重启 Synapse。这会使 `/requestToken` 端点返回保护隐私的响应，而不是泄露某个电子邮件地址或其他第三方标识符是否已注册。

```yaml
request_token_inhibit_3pid_errors: true
```

包含 issue #18415 修复的较新 Synapse 版本会将其默认设为 `true`。如果你更偏好以往注重可用性的行为，请显式将其设为 `false`：

```yaml
request_token_inhibit_3pid_errors: false
```

对于更严格的隐私要求，你还可以通过 `matrix-authentication-service` 处理认证流程。

synapse

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐