← 所有文章
指南

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。

UnifyPort API

让消息接入变成一条稳定的产品管线。

先用统一 API 跑通发送,再用标准事件把所有入站消息接回业务系统。