使用.NET6 WebAPI无法上传文件：本地端口未显示且遇CS8618警告

核心问题分析 #

你遇到的两个关键问题：

1. CS8618警告：.NET6启用了可空引用类型，fileModel的files属性标记为非可空，但未在构造函数中初始化。
2. 程序运行终止：控制器的UploadFile方法存在无限递归调用（调用自身而非服务方法），导致栈溢出崩溃；同时缺少依赖注入配置、模型绑定标记和路径拼接问题。

分步修复代码 #

1. 修复FileModel的CS8618警告（三选一）

推荐使用.NET6+的required关键字明确属性必须赋值：

public class FileModel
{
    // 遵循PascalCase命名规范，同时用required标记必填属性
    public required IFormFile Files { get; set; }
}

备选方案（允许可空但显式检查）：

public class FileModel
{
    public IFormFile? Files { get; set; }
}

2. 修复控制器的递归问题与依赖注入

控制器需要注入文件上传服务，且避免递归调用：

public class FilesController : ControllerBase
{
    private readonly IFileUpload _fileUploadService;

    // 通过构造函数注入服务
    public FilesController(IFileUpload fileUploadService)
    {
        _fileUploadService = fileUploadService;
    }

    [HttpPost]
    // 添加[FromForm]标记，确保从multipart/form-data中绑定文件
    public string UploadFile([FromForm] FileModel objFile)
    {
        try
        {
            // 检查文件是否有效
            if (objFile.Files == null || objFile.Files.Length == 0)
            {
                return "Failed: 未上传有效文件";
            }

            // 调用服务的上传方法，而非自身Action
            _fileUploadService.UploadFile(objFile);
            return $"上传成功: {objFile.Files.FileName}";
        }
        catch (Exception ex)
        {
            return $"错误: {ex.Message}";
        }
    }
}

3. 修复文件上传服务的路径拼接问题

使用Path.Combine避免硬编码路径分隔符，同时增加空值检查：

public class FileUpload : IFileUpload
{
    private readonly IWebHostEnvironment _environment;

    public FileUpload(IWebHostEnvironment environment)
    {
        _environment = environment;
    }

    public void UploadFile(FileModel formFile)
    {
        if (formFile.Files == null)
        {
            throw new ArgumentNullException(nameof(formFile.Files), "文件不能为空");
        }

        // 安全拼接上传路径
        var uploadPath = Path.Combine(_environment.WebRootPath, "Uploads");
        
        if (!Directory.Exists(uploadPath))
        {
            Directory.CreateDirectory(uploadPath);
        }

        var filePath = Path.Combine(uploadPath, formFile.Files.FileName);
        
        using (FileStream fileStream = System.IO.File.Create(filePath))
        {
            formFile.Files.CopyTo(fileStream);
            fileStream.Flush();
        }
    }
}

4. 注册服务到依赖注入容器

在Program.cs中添加服务注册：

// 注册文件上传服务
builder.Services.AddScoped<IFileUpload, FileUpload>();

测试注意事项 #

使用Postman/Swagger发送请求时：

• 请求方法：POST
• 请求体：multipart/form-data
• Key值：Files（需与FileModel的属性名完全一致）
• Value：选择本地文件上传

内容的提问来源于stack exchange，提问作者Muhammed Irshad