Asp.NET Core 6集成CKEditor 4上传文件后出现500错误求助

HTTP error occurred during file upload (error status: 500).

使用Asp.NET Core 6和CKEditor 4时，点击上传按钮上传本地图片，文件已成功保存到服务器的FilesCKEditor目录，但CKEditor弹出上述500错误提示，且图片浏览对话框未收到返回状态。

已配置静态文件中间件如下：

app.UseStaticFiles(new StaticFileOptions()
{
    FileProvider = new PhysicalFileProvider(
        System.IO.Path.Combine(System.IO.Directory.GetCurrentDirectory(), "FilesCKEditor")),
    RequestPath = "/FilesCKEditor"
});

排查与解决步骤 #

• 检查上传接口的返回格式是否符合CKEditor要求
  CKEditor 4的文件上传接口必须返回特定格式的JSON，否则会判定为错误。正确的成功返回格式如下：

  {
      "uploaded": 1,
      "fileName": "example.jpg",
      "url": "/FilesCKEditor/example.jpg"
  }
  

  若接口返回格式缺失必填字段、路径错误，都会触发CKEditor的错误提示。

• 验证上传请求的实际响应状态
  用浏览器开发者工具的Network面板或Postman查看上传请求的真实响应：

  1. 打开浏览器F12，切换到Network标签
  2. 触发图片上传，定位到对应的上传请求
  3. 查看Response内容和Status Code，确认是真的返回500，还是CKEditor因格式问题误判

• 确认目录权限配置
  即使文件已上传，服务器可能无FilesCKEditor目录的读取权限，导致静态文件无法访问。确保应用程序运行身份（如IIS的AppPool用户）对该目录拥有读取权限。

• 调整静态文件中间件的注册顺序
  Asp.NET Core中间件的执行顺序至关重要，UseStaticFiles必须在UseRouting和UseEndpoints之前注册，确保静态文件请求被优先处理：

  var builder = WebApplication.CreateBuilder(args);
  // 添加服务逻辑...
  var app = builder.Build();
  
  // 先注册静态文件中间件
  app.UseStaticFiles(); // 处理默认wwwroot目录的静态文件
  app.UseStaticFiles(new StaticFileOptions()
  {
      FileProvider = new PhysicalFileProvider(
          System.IO.Path.Combine(System.IO.Directory.GetCurrentDirectory(), "FilesCKEditor")),
      RequestPath = "/FilesCKEditor"
  });
  
  app.UseRouting();
  app.UseAuthorization();
  
  app.MapControllers();
  app.Run();
  

• 在上传接口中添加异常捕获
  上传接口可能存在未捕获的异常导致返回500，添加异常捕获并输出具体错误信息，方便排查：

  [HttpPost]
  public IActionResult Upload(IFormFile upload)
  {
      try
      {
          var fileName = System.IO.Path.GetFileName(upload.FileName);
          var filePath = System.IO.Path.Combine(System.IO.Directory.GetCurrentDirectory(), "FilesCKEditor", fileName);
          using (var stream = new System.IO.FileStream(filePath, System.IO.FileMode.Create))
          {
              upload.CopyTo(stream);
          }
          var url = $"/FilesCKEditor/{fileName}";
          return Json(new { uploaded = 1, fileName = fileName, url = url });
      }
      catch (System.Exception ex)
      {
          // 记录日志或直接返回错误信息
          return Json(new { uploaded = 0, error = new { message = ex.Message } });
      }
  }
  

内容的提问来源于stack exchange，提问作者Hadi Mazareei