abp-next-admin2

这是基于vue-vben-admin 模板适用于abp vNext的前端管理项目

28 KiB

Raw Blame History

现在我已经收集了足够的信息来创建关于消息服务集成的详细文档。让我开始编写文档：

# 消息服务集成 **本文档中引用的文件** - [PushPlusMessageSender.cs](file://aspnet-core/framework/pushplus/LINGYUN.Abp.PushPlus/LINGYUN/Abp/PushPlus/Message/PushPlusMessageSender.cs) - [WxPusherMessageSender.cs](file://aspnet-core/framework/wx-pusher/LINGYUN.Abp.WxPusher/LINGYUN/Abp/WxPusher/Messages/WxPusherMessageSender.cs) - [AliyunSmsSender.cs](file://aspnet-core/framework/common/LINGYUN.Abp.Sms.Aliyun/LINGYUN/Abp/Sms/Aliyun/AliyunSmsSender.cs) - [TencentCloudSmsSender.cs](file://aspnet-core/framework/cloud-tencent/LINGYUN.Abp.Sms.Tencent/LINGYUN/Abp/Sms/Tencent/TencentCloudSmsSender.cs) - [TuiJuheMessageSender.cs](file://aspnet-core/framework/tui-juhe/LINGYUN.Abp.TuiJuhe/LINGYUN/Abp/TuiJuhe/Messages/TuiJuheMessageSender.cs) - [PlatformSmsSender.cs](file://aspnet-core/services/LY.MicroService.PlatformManagement.HttpApi.Host/Messages/PlatformSmsSender.cs) - [PlatformSmsMessageManager.cs](file://aspnet-core/services/LY.MicroService.PlatformManagement.HttpApi.Host/Messages/PlatformSmsMessageManager.cs) - [PushPlusFeatureDefinitionProvider.cs](file://aspnet-core/framework/pushplus/LINGYUN.Abp.PushPlus/LINGYUN/Abp/PushPlus/Features/PushPlusFeatureDefinitionProvider.cs) - [Message.cs](file://aspnet-core/modules/platform/LINGYUN.Platform.Domain/LINGYUN/Platform/Messages/Message.cs) - [MessageStatus.cs](file://aspnet-core/modules/platform/LINGYUN.Platform.Domain.Shared/LINGYUN/Platform/Messages/MessageStatus.cs) - [AliyunSmsResponse.cs](file://aspnet-core/framework/common/LINGYUN.Abp.Sms.Aliyun/LINGYUN/Abp/Sms/Aliyun/AliyunSmsResponse.cs)

简介

本文档详细介绍了ABP Next Admin框架中的消息服务集成系统，重点涵盖短信、推送通知等多种消息通道的集成方式。该系统提供了完整的消息服务解决方案，包括阿里云短信、腾讯云短信、PushPlus、TuiJuhe和WxPusher等主流消息服务的配置和使用方法。

消息服务集成系统采用模块化设计，支持多种消息类型（短信、邮件、推送通知等）和多个消息提供商，具有完善的限流控制、错误处理和状态跟踪功能。系统通过统一的接口设计，实现了消息发送的标准化和可扩展性。

项目结构

消息服务集成系统的项目结构按照功能模块进行组织，主要包含以下几个层次：

graph TB
subgraph "框架层"
A[PushPlus框架]
B[WxPusher框架]
C[阿里云短信框架]
D[腾讯云短信框架]
E[TuiJuhe框架]
end
subgraph "模块层"
F[实时通知模块]
G[平台管理模块]
H[消息服务域]
end
subgraph "服务层"
I[消息发送器]
J[消息管理器]
K[集成服务]
end
A --> F
B --> F
C --> G
D --> G
E --> F
F --> I
G --> J
H --> K

图表来源

PushPlusMessageSender.cs
WxPusherMessageSender.cs

章节来源

PushPlusMessageSender.cs
WxPusherMessageSender.cs

核心组件

消息服务集成系统的核心组件包括消息发送器、消息管理器和消息模板管理器。这些组件协同工作，提供完整的消息发送解决方案。

消息发送器

消息发送器是系统的核心组件，负责与各个消息提供商进行交互。每个消息提供商都有对应的发送器实现：

PushPlusMessageSender: 支持微信、企业微信、邮件、Webhook和短信等多种渠道
WxPusherMessageSender: 专注于微信推送服务
AliyunSmsSender: 阿里云短信服务发送器
TencentCloudSmsSender: 腾讯云短信服务发送器
TuiJuheMessageSender: 推聚互动短信服务发送器

消息管理器

消息管理器负责消息的生命周期管理，包括消息创建、存储和发送协调：

PlatformSmsMessageManager: 平台短信消息管理器
PlatformEmailMessageManager: 平台邮件消息管理器

消息模板管理器

消息模板管理器负责消息模板的管理和渲染，支持多种消息内容类型。

章节来源

PushPlusMessageSender.cs
WxPusherMessageSender.cs

架构概览

消息服务集成系统采用分层架构设计，通过抽象接口和具体实现分离的方式，实现了高度的可扩展性和可维护性。

sequenceDiagram
participant Client as 客户端
participant Manager as 消息管理器
participant Sender as 消息发送器
participant Provider as 消息提供商
participant Storage as 存储层
Client->>Manager : 创建消息请求
Manager->>Storage : 保存消息到数据库
Manager->>Sender : 调用发送器
Sender->>Provider : 发送消息请求
Provider-->>Sender : 返回发送结果
Sender->>Storage : 更新消息状态
Sender-->>Manager : 返回发送状态
Manager-->>Client : 返回最终结果
Note over Client,Storage : 异步消息发送流程

图表来源

PlatformSmsMessageManager.cs
PushPlusMessageSender.cs

详细组件分析

PushPlus消息发送器

PushPlus消息发送器是最为全面的消息发送器之一，支持多种消息渠道和模板类型。

classDiagram
class PushPlusMessageSender {
+ILogger Logger
+IClock Clock
+IJsonSerializer JsonSerializer
+ISettingProvider SettingProvider
+IHttpClientFactory HttpClientFactory
+SendWeChatAsync(title, content, topic) string
+SendWeWorkAsync(title, content, topic) string
+SendEmailAsync(title, content, topic) string
+SendWebhookAsync(title, content, topic) string
+SendSmsAsync(title, content, topic) string
#SendAsync(title, content, topic, template, channel) string
-GetTemplate(template) string
}
class IPushPlusMessageSender {
<<interface>>
+SendWeChatAsync(title, content, topic) Task~string~
+SendWeWorkAsync(title, content, topic) Task~string~
+SendEmailAsync(title, content, topic) Task~string~
+SendWebhookAsync(title, content, topic) Task~string~
+SendSmsAsync(title, content, topic) Task~string~
}
class PushPlusMessageTemplate {
<<enumeration>>
Html
Text
Json
Markdown
CloudMonitor
Jenkins
Route
}
PushPlusMessageSender ..|> IPushPlusMessageSender
PushPlusMessageSender --> PushPlusMessageTemplate

图表来源

PushPlusMessageSender.cs
PushPlusMessageTemplate.cs

PushPlus消息发送器的主要特点：

多渠道支持: 支持微信、企业微信、邮件、Webhook和短信等多种消息渠道
模板化消息: 提供多种消息模板类型，支持HTML、纯文本、JSON、Markdown等格式
限流控制: 每个渠道都配置了独立的发送限制和时间间隔
异步发送: 所有发送操作都是异步的，提高系统响应性能

阿里云短信发送器

阿里云短信发送器专门用于发送短信消息，集成了阿里云短信服务的各项功能。

flowchart TD
Start([开始发送短信]) --> ValidateParams["验证参数"]
ValidateParams --> CheckFeature{"检查功能开关"}
CheckFeature --> |关闭| ReturnError["返回错误"]
CheckFeature --> |开启| GetSettings["获取配置设置"]
GetSettings --> CreateRequest["创建请求对象"]
CreateRequest --> AddTemplate["添加模板参数"]
AddTemplate --> AddSign["添加签名参数"]
AddSign --> AddPhone["添加手机号参数"]
AddPhone --> SendRequest["发送HTTP请求"]
SendRequest --> CheckResponse{"检查响应"}
CheckResponse --> |成功| UpdateStatus["更新发送状态"]
CheckResponse --> |失败| HandleError["处理错误"]
HandleError --> ThrowException["抛出异常"]
UpdateStatus --> End([发送完成])
ReturnError --> End

图表来源

AliyunSmsSender.cs

阿里云短信发送器的关键特性：

配置驱动: 通过设置提供程序动态获取阿里云配置
模板化发送: 支持短信模板和动态参数替换
错误处理: 完善的错误码映射和用户友好的错误信息
限流控制: 基于月度发送量的限流机制

章节来源

PushPlusMessageSender.cs
AliyunSmsSender.cs

腾讯云短信发送器

腾讯云短信发送器提供了与腾讯云短信服务的完整集成，支持签名、模板和参数的灵活配置。

classDiagram
class TencentCloudSmsSender {
+ILogger Logger
+IJsonSerializer JsonSerializer
+ISettingProvider SettingProvider
+IServiceProvider ServiceProvider
+TencentCloudClientFactory SmsClient
+SendAsync(smsMessage) Task
-TryAddTemplateCodeAsync(request, message) Task
-TryAddSignNameAsync(request, message) Task
-TryAddSendPhoneAsync(request, message) Task
-TryAddTemplateParam(request, message) void
}
class ISmsSender {
<<interface>>
+SendAsync(smsMessage) Task
}
class SendSmsRequest {
+string SmsSdkAppId
+string SignName
+string TemplateId
+string[] PhoneNumberSet
+string[] TemplateParamSet
}
TencentCloudSmsSender ..|> ISmsSender
TencentCloudSmsSender --> SendSmsRequest

图表来源

TencentCloudSmsSender.cs

腾讯云短信发送器的特点：

标准化接口: 使用腾讯云官方SDK的标准接口
灵活配置: 支持动态设置签名和模板
批量发送: 支持向多个手机号批量发送短信
错误码映射: 将腾讯云错误码映射为可读的错误信息

章节来源

TencentCloudSmsSender.cs

WxPusher消息发送器

WxPusher消息发送器专注于微信推送服务，提供了简洁而强大的消息发送功能。

sequenceDiagram
participant Client as 客户端
participant Sender as WxPusher发送器
participant TokenProvider as 令牌提供者
participant HttpClient as HTTP客户端
participant WxPusherAPI as WxPusher API
Client->>Sender : SendAsync(content, summary, ...)
Sender->>TokenProvider : 获取访问令牌
TokenProvider-->>Sender : 返回令牌
Sender->>HttpClient : 创建发送消息对象
HttpClient->>WxPusherAPI : POST /api/send/message
WxPusherAPI-->>HttpClient : 返回发送结果
HttpClient-->>Sender : 解析响应数据
Sender-->>Client : 返回发送结果列表

图表来源

WxPusherMessageSender.cs

WxPusher消息发送器的优势：

简单易用: 提供简洁的API接口
主题支持: 支持按主题ID或用户UID发送消息
内容类型: 支持多种消息内容类型
批量发送: 支持同时发送给多个接收者

章节来源

WxPusherMessageSender.cs

消息模板管理

消息模板管理系统负责管理不同类型的消息模板，支持HTML、纯文本、JSON、Markdown等多种模板格式。

模板类型定义

系统支持以下消息模板类型：

graph LR
A[消息模板] --> B[HTML模板]
A --> C[纯文本模板]
A --> D[JSON模板]
A --> E[Markdown模板]
A --> F[云监控模板]
A --> G[Jenkins模板]
A --> H[路由器模板]

每种模板类型都有其特定的应用场景：

HTML模板: 适用于富文本消息，支持样式和链接
纯文本模板: 适用于简单文本消息，不进行HTML转义
JSON模板: 适用于结构化数据传输
Markdown模板: 适用于Markdown格式的消息
专用模板: 适用于特定场景的定制模板

模板参数管理

消息模板支持动态参数替换，允许在发送时传入具体的参数值。例如：

// 示例：阿里云短信模板参数
var templateParams = new Dictionary<string, object>
{
    { "code", "123456" },        // 验证码
    { "product", "ABC产品" },     // 产品名称
    { "expire", "5分钟" }         // 过期时间
};

章节来源

PushPlusMessageTemplate.cs

消息发送API

消息发送API提供了统一的接口来发送各种类型的消息。所有消息发送器都实现了标准的发送接口。

基础发送接口

// 基础消息发送接口
public interface ISmsSender
{
    Task SendAsync(SmsMessage smsMessage);
}

// 推送消息发送接口
public interface IPushPlusMessageSender
{
    Task<string> SendWeChatAsync(string title, string content, string topic = "");
    Task<string> SendEmailAsync(string title, string content, string topic = "");
    Task<string> SendWeWorkAsync(string title, string content, string topic = "");
    Task<string> SendWebhookAsync(string title, string content, string topic = "");
    Task<string> SendSmsAsync(string title, string content, string topic = "");
}

异步发送最佳实践

系统推荐使用异步发送模式，以提高系统性能和响应能力：

// 异步发送示例
public async Task SendMessageAsync()
{
    try
    {
        var result = await messageSender.SendAsync(message);
        // 处理发送成功逻辑
    }
    catch (Exception ex)
    {
        // 处理发送失败逻辑
        Logger.LogError(ex, "消息发送失败");
    }
}

批量发送支持

对于需要同时发送多条消息的场景，系统提供了批量发送的支持：

// 批量发送示例
public async Task SendBatchMessagesAsync(List<Message> messages)
{
    var tasks = messages.Select(async message => 
    {
        try
        {
            return await messageSender.SendAsync(message);
        }
        catch (Exception ex)
        {
            return new SendResult { Success = false, Error = ex.Message };
        }
    });
    
    var results = await Task.WhenAll(tasks);
    // 处理批量发送结果
}

章节来源

PushPlusMessageSender.cs

发送状态跟踪

消息发送状态跟踪系统提供了完整的消息生命周期管理，包括消息创建、发送过程监控和发送结果记录。

消息状态定义

stateDiagram-v2
[*] --> Pending : 创建消息
Pending --> Sent : 发送成功
Pending --> Failed : 发送失败
Sent --> [*] : 完成
Failed --> [*] : 完成
note right of Pending : 未发送状态
note right of Sent : 已发送状态
note right of Failed : 发送失败状态

图表来源

MessageStatus.cs

消息状态包括：

Pending（待发送）: 消息已创建但尚未发送
Sent（已发送）: 消息发送成功
Failed（发送失败）: 消息发送失败

状态更新机制

消息状态更新通过以下方式实现：

// 状态更新示例
public class Message
{
    public void Sent(IClock clock)
    {
        SendCount += 1;
        SendTime = clock.Now;
        Status = MessageStatus.Sent;
        Reason = "";
    }

    public void Failed(string error, IClock clock)
    {
        SendTime = clock.Now;
        Status = MessageStatus.Failed;
        Reason = error.Truncate(MessageConsts.MaxReasonLength);
    }
}

发送历史记录

系统自动记录每次消息发送的历史记录，包括发送时间、发送次数和失败原因等信息。

章节来源

Message.cs

错误处理机制

消息服务集成系统实现了完善的错误处理机制，能够捕获和处理各种可能的错误情况。

错误分类

系统将错误分为以下几类：

网络错误: 包括连接超时、DNS解析失败等
认证错误: 包括API密钥无效、权限不足等
参数错误: 包括必填参数缺失、参数格式错误等
业务错误: 包括发送限制、内容违规等
系统错误: 包括服务不可用、内部异常等

错误处理策略

flowchart TD
Start([消息发送开始]) --> TrySend["尝试发送"]
TrySend --> CheckError{"检查错误类型"}
CheckError --> |网络错误| Retry["重试机制"]
CheckError --> |认证错误| LogError["记录错误"]
CheckError --> |参数错误| ValidateParams["验证参数"]
CheckError --> |业务错误| HandleBusiness["处理业务逻辑"]
CheckError --> |系统错误| Fallback["降级处理"]
Retry --> CheckRetryCount{"检查重试次数"}
CheckRetryCount --> |未超限| TrySend
CheckRetryCount --> |超限| LogError
ValidateParams --> ReturnError["返回参数错误"]
HandleBusiness --> ReturnBusinessError["返回业务错误"]
Fallback --> UseAlternative["使用备用方案"]
LogError --> End([发送结束])
ReturnError --> End
ReturnBusinessError --> End
UseAlternative --> End

具体错误处理实现

以阿里云短信为例，系统实现了详细的错误处理：

// 阿里云短信错误处理
try
{
    var client = await AcsClientFactory.CreateAsync();
    CommonResponse response = client.GetCommonResponse(request);
    var responseContent = Encoding.Default.GetString(response.HttpResponse.Content);
    var aliyunResponse = JsonSerializer.Deserialize<AliyunSmsResponse>(responseContent);
    
    if (!aliyunResponse.IsSuccess())
    {
        if (await SettingProvider.IsTrueAsync(AliyunSettingNames.Sms.VisableErrorToClient))
        {
            throw new UserFriendlyException(aliyunResponse.Code, aliyunResponse.Message);
        }
        throw new AliyunSmsException(aliyunResponse.Code, 
            $"Text message sending failed, code:{aliyunResponse.Code}, message:{aliyunResponse.Message}!");
    }
}
catch(ServerException se)
{
    throw new AliyunSmsException(se.ErrorCode, 
        $"Sending text messages to aliyun server is abnormal,type: {se.ErrorType}, error: {se.ErrorMessage}");
}
catch(ClientException ce)
{
    throw new AliyunSmsException(ce.ErrorCode, 
        $"A client exception occurred in sending SMS messages,type: {ce.ErrorType}, error: {ce.ErrorMessage}");
}

用户友好错误信息

系统将技术性的错误码转换为用户友好的错误信息，便于理解和处理：

// 错误码映射示例
public static ILocalizableString GetErrorMessage(string code, string message)
{
    switch (code)
    {
        case "isv.SMS_SIGNATURE_SCENE_ILLEGAL":
            return LocalizableString.Create<AliyunResource>("SMS_SIGNATURE_SCENE_ILLEGAL");
        case "isv.DENY_IP_RANGE":
            return LocalizableString.Create<AliyunResource>("DENY_IP_RANGE");
        case "isv.MOBILE_COUNT_OVER_LIMIT":
            return LocalizableString.Create<AliyunResource>("MOBILE_COUNT_OVER_LIMIT");
        // ... 更多错误码映射
        default:
            throw new AbpException($"no error code: {code} define, message: {message}");
    }
}

章节来源

AliyunSmsSender.cs
AliyunSmsResponse.cs

限流策略与重试机制

消息服务集成系统实现了完善的限流策略和重试机制，确保系统的稳定性和可靠性。

限流策略

系统为每个消息提供商和渠道都配置了独立的限流策略：

graph TB
subgraph "PushPlus限流策略"
A[微信渠道: 200/天]
B[企业微信渠道: 200/天]
C[邮件渠道: 200/天]
D[Webhook渠道: 200/天]
E[短信渠道: 200/天]
end
subgraph "WxPusher限流策略"
F[每日发送限制: 500条]
G[发送间隔: 1天]
end
subgraph "阿里云短信限流策略"
H[月度发送限制: 无限制]
I[发送间隔: 1个月]
end

图表来源

PushPlusFeatureDefinitionProvider.cs

限流实现机制

限流通过特性装饰器和限制验证模块实现：

[RequiresLimitFeature(
    PushPlusFeatureNames.Channel.WeChat.SendLimit,
    PushPlusFeatureNames.Channel.WeChat.SendLimitInterval, 
    LimitPolicy.Days)]
public async virtual Task<string> SendWeChatAsync(...)
{
    // 实际发送逻辑
}

重试机制

系统实现了智能的重试机制，包括指数退避算法和最大重试次数限制：

flowchart TD
Start([开始发送]) --> SendAttempt["发送尝试"]
SendAttempt --> CheckResult{"检查结果"}
CheckResult --> |成功| Success["发送成功"]
CheckResult --> |失败| CheckRetryCount{"检查重试次数"}
CheckRetryCount --> |未超限| Wait["等待重试间隔"]
CheckRetryCount --> |超限| Failure["发送失败"]
Wait --> ExponentialBackoff["指数退避"]
ExponentialBackoff --> SendAttempt
Success --> End([结束])
Failure --> End

失败补偿方案

当消息发送失败时，系统提供了多种补偿方案：

自动重试: 对于临时性错误自动重试
降级处理: 使用备用消息提供商
异步补偿: 将失败消息放入队列进行后续处理
人工干预: 记录失败信息供人工处理

章节来源

PushPlusFeatureDefinitionProvider.cs

最佳实践

消息服务选择指南

根据不同的业务场景选择合适的消息服务：

flowchart TD
Start([业务需求]) --> ChannelType{"消息渠道类型"}
ChannelType --> |即时通讯| IM["即时通讯服务<br/>- PushPlus<br/>- WxPusher"]
ChannelType --> |短信通知| SMS["短信服务<br/>- 阿里云短信<br/>- 腾讯云短信<br/>- TuiJuhe"]
ChannelType --> |邮件通知| Email["邮件服务<br/>- PushPlus<br/>- 自建SMTP"]
ChannelType --> |系统监控| Monitor["监控告警<br/>- PushPlus<br/>- 专用监控服务"]
IM --> IMChoice{"选择标准"}
SMS --> SMSChoice{"选择标准"}
Email --> EmailChoice{"选择标准"}
Monitor --> MonitorChoice{"选择标准"}
IMChoice --> |稳定性| PushPlus
IMChoice --> |成本| WxPusher
SMSChoice --> |国内| Aliyun
SMSChoice --> |国际| Tencent
SMSChoice --> |成本敏感| TuiJuhe
EmailChoice --> |品牌邮件| PushPlus
EmailChoice --> |自定义| SMTP
MonitorChoice --> |企业级| PushPlus
MonitorChoice --> |开源| 专用监控

配置最佳实践

环境隔离: 不同环境使用不同的配置
密钥管理: 使用安全的密钥存储和轮换机制
监控告警: 设置发送成功率和延迟的监控告警
日志记录: 记录所有消息发送的详细日志

性能优化建议

异步发送: 所有消息发送都应使用异步模式
批量处理: 合理使用批量发送减少网络开销
缓存策略: 缓存频繁使用的配置和模板
连接池: 使用连接池管理HTTP连接

安全考虑

API密钥保护: 不要将API密钥硬编码在代码中
网络通信: 使用HTTPS加密通信
输入验证: 对所有外部输入进行严格验证
访问控制: 实施适当的访问控制和权限管理

故障排除指南

常见问题及解决方案

1. 消息发送失败

症状: 消息发送返回失败状态

排查步骤:

检查网络连接是否正常
验证API密钥是否正确
查看错误日志获取详细信息
检查消息内容是否符合要求

解决方案:

// 检查API密钥配置
var token = await SettingProvider.GetOrNullAsync(PushPlusSettingNames.Security.Token);
if (string.IsNullOrEmpty(token))
{
    throw new InvalidOperationException("PushPlus API Token未配置");
}

2. 发送限流

症状: 收到限流错误或被拒绝发送

排查步骤:

检查当前发送量是否超过限制
查看剩余发送配额
检查限流策略配置

解决方案:

实现指数退避重试机制
使用备用消息提供商
优化消息发送频率

3. 模板参数错误

症状: 消息内容显示异常或参数替换失败

排查步骤:

验证模板语法是否正确
检查参数数量和类型是否匹配
查看模板渲染结果

解决方案:

// 参数验证示例
private void ValidateTemplateParams(Dictionary<string, object> params)
{
    if (params == null || params.Count == 0)
    {
        throw new ArgumentException("模板参数不能为空");
    }
    
    foreach (var param in params)
    {
        if (param.Value == null)
        {
            throw new ArgumentException($"参数 {param.Key} 的值不能为空");
        }
    }
}

监控和诊断工具

日志监控

系统提供了详细的日志记录，包括：

消息发送请求和响应
错误详情和堆栈跟踪
性能指标和延迟统计
系统状态和健康检查

性能监控

监控关键性能指标：

消息发送成功率
平均发送延迟
最大并发发送数
错误率和重试率

健康检查

定期执行健康检查：

public async Task<HealthCheckResult> CheckHealthAsync(CancellationToken cancellationToken)
{
    try
    {
        // 测试消息发送功能
        var testMessage = new SmsMessage("1234567890", "测试消息");
        await smsSender.SendAsync(testMessage);
        
        return HealthCheckResult.Healthy("消息服务正常");
    }
    catch (Exception ex)
    {
        return HealthCheckResult.Unhealthy($"消息服务异常: {ex.Message}");
    }
}

章节来源

AliyunSmsResponse.cs

结论

ABP Next Admin框架的消息服务集成系统提供了完整而强大的消息发送解决方案。通过模块化的架构设计，系统支持多种消息提供商和消息类型，具备完善的限流控制、错误处理和状态跟踪功能。

主要优势

统一接口: 提供统一的消息发送接口，简化开发复杂度
多提供商支持: 支持主流的消息服务提供商，满足不同需求
完善的错误处理: 提供详细的错误信息和处理策略
灵活的配置: 支持动态配置和环境隔离
高性能设计: 采用异步发送和批量处理提升性能

应用建议

根据业务需求选择合适的提供商: 考虑稳定性、成本和功能需求
实施监控和告警: 建立完善的消息发送监控体系

28 KiB Raw Blame History

目录

简介

项目结构

核心组件

消息发送器

消息管理器

消息模板管理器

架构概览

详细组件分析

PushPlus消息发送器

阿里云短信发送器

腾讯云短信发送器

WxPusher消息发送器

消息模板管理

模板类型定义

模板参数管理

消息发送API

基础发送接口

异步发送最佳实践

批量发送支持

发送状态跟踪

消息状态定义

状态更新机制

发送历史记录

错误处理机制

错误分类

错误处理策略

具体错误处理实现

用户友好错误信息

限流策略与重试机制

限流策略

限流实现机制

重试机制

失败补偿方案

最佳实践

消息服务选择指南

配置最佳实践

性能优化建议

安全考虑

故障排除指南

常见问题及解决方案

1. 消息发送失败

2. 发送限流

3. 模板参数错误

监控和诊断工具

日志监控

性能监控

健康检查

结论

主要优势

应用建议

28 KiB

Raw Blame History