XF发送POST请求遇StatusCode 500及415错误求助

问题根源分析 #

你的两次调用失败分别由不同原因导致：

1. 第一次JSON POST调用（500错误）

• 参数名不匹配：后端API的参数名为deviceTokens、title、body、linkdirection，但XF请求中传递的参数名是devicetoken、titlefirebase、bodyfirebase、linkfirebase，ASP.NET Core无法完成模型绑定，导致后端逻辑出错。
• 缺失必填参数：API定义了object data参数，但XF请求中完全未传递该参数，若后端未处理data为null的情况，会引发空引用或参数绑定异常，最终导致500内部错误。
• 同步方法阻塞风险：后端接口是同步方法，但内部使用.Result等待异步操作完成，在某些上下文下可能引发死锁，虽然Postman调用正常，但XF的异步调用环境可能触发该问题。

2. 第二次QueryString POST调用（415错误）

• ASP.NET Core的[HttpPost]接口默认从请求体绑定参数，你的请求仅通过URL传递QueryString，但未添加[FromQuery]特性告诉框架从URL读取参数，导致框架无法识别参数来源；同时Post请求未携带符合要求的请求体，引发Unsupported Media Type错误。

解决方案 #

方案一：修正JSON POST请求（推荐）

1. 统一参数名：XF请求的匿名对象参数名必须与后端API完全一致，同时补上data参数：

public async Task AddNotifyFirebase(string devicetoken, string titlefirebase, string bodyfirebase, string linkfirebase)
{
    // 参数名与后端API保持一致，补充data参数（可传null或实际业务数据）
    var model = new
    {
        deviceTokens = devicetoken,
        title = titlefirebase,
        body = bodyfirebase,
        data = (object)null, // 或传入具体的业务对象
        linkdirection = linkfirebase
    };
    var json = JsonConvert.SerializeObject(model);
    var content = new StringContent(json, Encoding.UTF8, "application/json");

    var request = new HttpRequestMessage(HttpMethod.Post, "https://linkapi/api/SendNotifyDeviceFirebase");
    request.Content = content;

    var response = await client.SendAsync(request);

    if (response.IsSuccessStatusCode)
    {
        var responseBody = await response.Content.ReadAsStringAsync();
    }    
}

2. 后端优化：将接口改为异步方法，避免.Result引发的死锁问题，同时使用强类型DTO替代object data，提升模型绑定可靠性：

// 定义DTO类
public class FcmNotificationRequest
{
    public string DeviceTokens { get; set; }
    public string Title { get; set; }
    public string Body { get; set; }
    public object Data { get; set; }
    public string Linkdirection { get; set; }
}

// 修改接口为异步+FromBody绑定
[HttpPost]
public async Task<IActionResult> PushNotificationToFCM([FromBody] FcmNotificationRequest request)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState); // 返回参数错误，方便排查
    }

    var registrationToken = request.DeviceTokens;
    var message = new Message()
    {
        Apns = new ApnsConfig { Aps = new Aps { ContentAvailable = true, Sound = "default" } },
        Data = new Dictionary<string, string>()
        {
            { "link", request.Linkdirection },
        },
        Token = registrationToken,
        Notification= new FirebaseAdmin.Messaging.Notification()
        {
            Title = request.Title,
            Body = request.Body,
        }
    };

    // 使用await替代.Result
    string response = await FirebaseMessaging.DefaultInstance.SendAsync(message);
    Debug.WriteLine("Successfully sent message: " + response);
    return Ok(response);
}

方案二：使用QueryString调用（不推荐，Post请求更适合传Body）

若坚持用QueryString传递参数，需修改后端接口添加[FromQuery]特性，同时确保Post请求携带合法的请求体：

// 后端接口添加FromQuery特性
[HttpPost]
public async Task<IActionResult> PushNotificationToFCM(
    [FromQuery] string deviceTokens, 
    [FromQuery] string title, 
    [FromQuery] string body, 
    [FromQuery] object data, 
    [FromQuery] string linkdirection)
{
    // 原有逻辑...
}

// XF请求添加空的JSON内容，避免415错误
public async Task AddNotifyFirebase(string devicetoken, string titlefirebase, string bodyfirebase, string linkfirebase)
{
    var url = $"https://xxxxxx/api/SendNotifyDeviceFirebase?deviceTokens={Uri.EscapeDataString(devicetoken)}&title={Uri.EscapeDataString(titlefirebase)}&body={Uri.EscapeDataString(bodyfirebase)}&linkdirection={Uri.EscapeDataString(linkfirebase)}&data=null";
    var request = new HttpRequestMessage(HttpMethod.Post, url);
    // 添加空的JSON内容，满足Post请求的Content-Type要求
    request.Content = new StringContent("{}", Encoding.UTF8, "application/json");

    HttpResponseMessage response = await client.SendAsync(request);
    if (response.IsSuccessStatusCode)
    {
        var responseBody = await response.Content.ReadAsStringAsync();
    }    
}

关键排查步骤 #

• 查看后端服务器的日志（如Serilog、NLog或ASP.NET Core自带日志），获取500错误的具体异常信息（如空引用、参数绑定失败），这是定位问题最直接的方式。
• 在XF中捕获并打印响应的错误内容，通过await response.Content.ReadAsStringAsync()获取后端返回的详细错误信息。

内容的提问来源于stack exchange，提问作者Chim Di Tru