跳转至

name: feishu-group-policy-fix category: devops description: 飞书机器人群组策略排障 — 默认白名单导致群消息被拒的解决方案 trigger: 飞书机器人在群聊中无响应,或出现群消息被拒/忽略的情况


飞书机器人群组策略排障

问题现象

飞书机器人收到群消息但不回复/不处理,日志显示消息被策略拒绝。

根因

飞书机器人默认群组策略是 allowlist(白名单)FEISHU_ALLOWED_USERSFEISHU_GROUP_POLICY 均未设置时,所有群消息被拒。

解决方案

方案 A:放开默认策略(推荐,适合个人/小团队)

feishu.extra 配置中添加:

default_group_policy: open

或设置环境变量:

export FEISHU_GROUP_POLICY=open

方案 B:设置管理员绕过策略

在配置中添加 admins 列表,管理员用户免于策略检查:

admins:
  - "user_id_xxx"

验证

  1. 在群中 @机器人 发送测试消息
  2. 检查日志确认消息被正常接收和处理
  3. 如果仍被拒,检查具体策略日志确认是哪条规则拦截