LINE push 返回 200 却收不到消息?先检查接收条件
LINE Messaging API 的 push 请求即使返回 HTTP 200,用户也可能收不到消息。LINE 明确列出了账号已删除、用户封锁了发送方官方账号,以及不符合例外条件的非好友等情况。再次发送前,先核对实际发送的 channel、接收者 ID,以及用户与该官方账号的关系。HTTP 成功既不能证明送达,也不能证明对方封锁了你。
要点
- 检查真正的出站 push 请求,不要把 webhook 接收端返回的 200 当成发送结果。
- 非好友在一对一聊天中给该官方账号发过消息后,可以在七天内接收其 push 消息。
- 这不是适用于网站访客、群成员或所有登录用户的通用发送窗口。
- 已确认成功的请求不要自动重发;先检查接收条件,保留未确认的送达状态。
为什么 LINE push 成功却未收到
LINE Messaging API reference 列出了以下 push 发送条件:
| 目标 | 官方说明的条件 |
|---|---|
| 个人用户 | 已将发送方 LINE 官方账号加为好友 |
| 群聊或多人聊天 | 官方账号已加入该聊天 |
| 非好友个人用户 | 过去七天内曾在一对一聊天中向该官方账号发送消息 |
同一份文档说明:用户删除 LINE 账号、封锁发送方官方账号,或未加好友且不符合例外时,请求可以返回 200,但消息不会送达。
这些是可能原因,不是成功响应中已经确认的诊断。不要仅凭用户说“没收到”,就在 CRM 标注“客户已封锁”。也不要混淆目标类型:群聊中的互动不能证明用户曾发送符合条件的一对一消息。
对于延迟处理的客服任务,建议分别记录相关入站消息时间、任务创建时间和实际发送时间,并在出队发送时重新检查非好友条件。启动 AI 任务时仍在七天内,不代表已为未来发送保留资格。
沿着一次发送核对证据
以下是建议保留的应用诊断记录,不是新增的 LINE API 字段。
1. 找到真正相关的响应
确认 200 来自出站 push 请求。你的 webhook 返回成功只说明接收端确认了请求;自建队列 API 返回成功也可能只表示任务已保存。
保留请求方法、endpoint、时间、HTTP 状态和 x-line-request-id。LINE 开发规范 建议记录这些请求证据。不要记录 access token,也不要把客户消息正文复制到普通日志。
2. 同时核对发送方与接收者
检查已部署 worker 实际选用了哪个 channel access token、该 channel 对应哪个官方账号,以及目标 ID 的来源。测试与生产账号名称相似,不代表同一个账号;配置截图也不能替代实际运行证据。
LINE 用户 ID 文档 区分 API user ID、显示名称和用于搜索好友的 LINE ID,并说明 user ID 按 provider 划分。如果目标来自 LINE Login 或另一个集成,先按用户 ID 与 provider 不匹配排查指南核对映射。登录网站本身不能证明已添加发送方官方账号为好友。
3. 检查与当前官方账号的关系
对个人用户,检查可用的好友关系证据,或最近是否向这个官方账号发送过符合条件的一对一消息。CRM 的旧活动、网页访问,以及发给另一个账号的消息,都不是等价证据。
证据不足就保留“未知”。不要反复发送探测消息来判断对方是否封锁了账号。LINE 开发规范禁止向同一用户大量发送消息,诊断不应变成对方不需要的联系。
4. 区分接受、拒绝和结果未知
| 观察 | 下一步 |
|---|---|
push 返回 200,用户说未收到 | 检查身份与接收条件,不自动重发 |
| API 有非成功响应 | 按实际响应调查,不套用本篇的 200 情况 |
| 请求超时,没有响应 | 保留接受状态未知,进入独立重试流程 |
只有 webhook 返回 200 | 查明是否真正发出了出站请求 |
超时处理见 LINE retry key 指南。重试保护解决的是请求是否被接受的不确定性,不会改变接收条件,也不能使原本无法送达的成功请求变得可送达。
做受控验证,而不是循环重发
取得测试用户同意后,在 LINE 应用中核对准确的官方账号,确认预期好友关系,再通过同一个已部署 channel 发送一条容易辨认的测试消息。把 HTTP 记录与测试者在聊天内实际看到的内容对照,而不是只看通知横幅。
测试成功只证明该用户在那个时刻的路径可用,不能证明其他客户的关系,也不能解释所有历史缺失,更不构成重放旧任务的依据。
延迟任务逻辑可以用本地测试验证:非好友消息在实际发送前已超出七天条件;保存的目标来自错误集成;已接受的操作再次进入重试 worker。预期分别是挂起任务、进入身份核查,以及不重复发送。这些是建议测试场景,不是已取得的生产结果。
单独处理 UnifyPort 的证据
UnifyPort 非官方接口提供独立的消息账号连接路径。文本发送契约使用 account_id、to 和 message,成功示例返回 status: accepted。这不是送达回执,也不能恢复此前通过官方账号发送的 push。
渠道事件矩阵列出了 LINE 送达和已读事件映射,但明确不保证每个账号或部署都会产生所有已映射事件。收到回执后,只更新其指向的消息;缺少回执不能证明发送失败或被封锁。也不要仅凭显示名称相同,把另一个账号的回执关联到官方 push。
如果发送身份必须保持为 LINE 官方账号,就继续使用官方 Messaging API。更换发送身份不是自动恢复动作,也不会取消接收者的选择。
常见问题
HTTP 200 能证明客户封锁了官方账号吗?
不能。它既不证明送达,也不说明未送达的具体原因。LINE 文档列出了多种可能条件。
可以向未加好友的人发送 push 吗?
官方例外适用于过去七天内向该官方账号发送过一对一消息的用户,不能扩展到网站访问或群聊互动。
用户没看到消息,应该再发一次吗?
已确认请求成功后不要自动重发。先核对发送方、接收者、接收条件和证据。请求超时与已拿到 200 是不同问题。
下一步与参考资料
选择一条有问题的 push,对照官方 push 条件逐项检查。如果已经使用 UnifyPort,先阅读独立的发送契约,再设计送达状态标签。
官方来源核对日期:2026-11-18。
让消息接入变成一条稳定的产品管线。
先用统一 API 跑通发送,再用标准事件把所有入站消息接回业务系统。