如何在ASP.NET Core Web API中调用存储过程生成自增员工编号

需求是生成001、002格式的自增employeeNumber，在SQL Server中创建了存储过程GenerateEmployeeNumber2，但用EF Core CodeFirst开发的ASP.NET Core Web API调用时，Swagger/Postman返回HTTP 500错误，调试发现仓库类获取的nextEmployeeNumber值为null，无法正确返回格式化员工号给前端。

错误原因 #

1. 列名不匹配：存储过程返回的列名为NewEmployeeNumber，但仓库类中尝试将结果映射到Employee实体的employeeNumber属性，EF Core无法自动匹配不同名称的列，导致employeeNumber被赋值为null。
2. 查询方式不匹配：FromSqlRaw用于查询完整的实体集合，而存储过程仅返回单个字符串值，这种用法不符合EF Core的设计预期，容易引发映射问题。

解决方案 #

方案1：修改存储过程列名匹配实体属性 #

将存储过程的返回列名改为employeeNumber，让EF Core能直接映射到实体属性：

ALTER PROCEDURE [dbo].[GenerateEmployeeNumber2]
AS
BEGIN
    DECLARE @NextEmployeeNumber VARCHAR(10);
    DECLARE @MaxEmployeeNumber INT;

    -- 使用TRY_CAST避免非数字employeeNumber导致的转换错误
    SELECT @MaxEmployeeNumber = MAX(TRY_CAST(employeeNumber AS INT)) 
    FROM Employees

    IF @MaxEmployeeNumber IS NULL 
       SET @NextEmployeeNumber = '001'
    ELSE
       SET @NextEmployeeNumber = RIGHT('000' + CAST(@MaxEmployeeNumber + 1 AS varchar(10)), 3)

     SELECT @NextEmployeeNumber AS employeeNumber -- 修改列名匹配实体属性
END

方案2：直接查询单个值（推荐） #

使用Database.SqlQuery<string>直接执行存储过程并返回单个字符串，无需映射到Employee实体，更符合当前需求：

修改仓库类代码：

using EmployeeList.Data;
using Microsoft.EntityFrameworkCore;

namespace EmployeeList.Repository
{
    public class EmployeeNumberRepository
    {
        private readonly EmployeeListContext _Context;

        public EmployeeNumberRepository(EmployeeListContext Context)
        {
            _Context = Context;
        }

        public async Task<string> GnenerateNextEmployeeNumber()
        {
            // 直接查询单个字符串值
            var nextEmployeeNumber = await _Context.Database
               .SqlQuery<string>("EXEC GenerateEmployeeNumber2")
               .FirstOrDefaultAsync();

            return nextEmployeeNumber ?? "001"; // 兜底处理避免null
        }
    }
}

额外优化点 #

存储过程中使用TRY_CAST替代CAST，避免当employeeNumber存在非数字值时引发转换错误，提升鲁棒性。

验证 #

修改后重新运行API，调用GnenerateNextEmployeeNumber接口，即可正确获取001、002等格式化的员工编号。

内容的提问来源于stack exchange，提问作者Pratyush Sinha