.NET Core WebAPI图片URL无法访问求助（已启用UseStaticFiles）

核心问题：文件名格式错误 #

你代码里生成图片路径时，漏掉了文件名中的小数点：

• 上传时写的是 productId + "png"，实际保存的文件名是 {productId}png（比如123png）
• 但生成访问URL时用的是 productId + ".png"，对应路径是{productId}.png（比如123.png）
  这就导致URL指向的文件根本不存在，自然返回404。

其他优化与修复点 #

• 路径拼接别用字符串硬拼，用Path.Combine适配不同系统的路径分隔符，避免因\和/混用出问题
• 异常处理别直接吞掉，至少返回错误信息或记录日志，方便排查问题
• 上传逻辑里判断目录是否存在时，应该用Directory.Exists而非File.Exists

修正后的代码 #

[HttpPut("UploadImage")]
public async Task<IActionResult> UploadImage(IFormFile formFile, string productId)
{
    APIResponse response = new APIResponse();
    try
    {
        string filePath = GetFilePath(productId);
        if (!Directory.Exists(filePath))
        {
            Directory.CreateDirectory(filePath);
        }
        // 用Path.Combine拼接路径，加上正确的文件后缀
        string imagePath = Path.Combine(filePath, $"{productId}.png");
        if (System.IO.File.Exists(imagePath))
        {
            System.IO.File.Delete(imagePath);
        }
        using (FileStream stream = System.IO.File.Create(imagePath))
        {
            await formFile.CopyToAsync(stream);
            response.ResponseCode = 200;
            response.Result = "pass";
        }
    }
    catch (Exception ex)
    {
        response.ErrorMessage = ex.Message;
        // 建议添加日志记录：_logger.LogError(ex, "图片上传失败");
    }
    return Ok(response);
}

[HttpGet("GetImage")]
public async Task<IActionResult> GetImage(string productId)
{
    string imageUrl = string.Empty;
    string hostUrl = $"{Request.Scheme}://{Request.Host}{Request.PathBase}";
    try
    {
        string filePath = GetFilePath(productId);
        string imagePath = Path.Combine(filePath, $"{productId}.png");
        if (System.IO.File.Exists(imagePath))
        {
            imageUrl = $"{hostUrl}/Upload/Product/{productId}/{productId}.png";
        }
        else
        {
            return NotFound("图片不存在");
        }
    }
    catch(Exception ex)
    {
        return StatusCode(500, $"获取图片失败：{ex.Message}");
    }
    return Ok(imageUrl);
}

[NonAction]
public string GetFilePath(string productId)
{
    // 用Path.Combine规范拼接WebRoot路径
    return Path.Combine(environment.WebRootPath, "Upload", "Product", productId);
}

验证步骤 #

1. 重新上传图片，检查wwwroot/Upload/Product/{productId}目录下的文件名是否为{productId}.png
2. 调用GetImage接口，复制返回的URL到浏览器直接访问，确认能正常打开图片
3. 如果仍无法访问，检查：
   • Program.cs中app.UseStaticFiles()是否在app.MapControllers()之前配置
   • 应用运行时WebRootPath的实际路径（可通过日志输出environment.WebRootPath确认）
   • 部署环境下文件夹和文件的读写权限（比如IIS站点的应用池权限）

内容的提问来源于stack exchange，提问作者Thanh Sơn