使用ABP框架：接口端点命名为何重复？如何修复？

问题原因 #

ABP框架会自动为应用服务生成RESTful风格的API路由，你的情况是框架默认路由规则导致的重复：

• 基础前缀：应用服务默认使用/api/app/作为路由前缀
• 服务名称：从实现的接口ILessonService自动提取，去掉前缀I和后缀Service，得到lesson
• 方法路由部分：框架默认会剔除方法名中的动作前缀（如Create、Get、Update等），你的方法名是CreateLessonAsync，剔除Create后剩下Lesson，最终拼接出/api/app/lesson/lesson

而/api/account/login这类路由，是因为对应的方法名（如LoginAsync）没有被框架识别的动作前缀，直接使用方法名作为路由部分，同时服务名提取为account，因此形成简洁的路由格式。

修复方案 #

方案一：显式指定方法路由（推荐） #

在CreateLessonAsync方法上添加[HttpPost]特性并指定路由路径，让路由风格和其他接口统一：

public class LessonAppService : ApplicationService, ILessonService
{
    private readonly IRepository<Lesson, Guid> _lessonRepository;

    public LessonAppService(IRepository<Lesson, Guid> lessonRepository)
    {
        _lessonRepository = lessonRepository;
    }

    [HttpPost("create")] // 显式指定路由后缀
    public async Task CreateLessonAsync(CreateLessonDTO input)
    {
        try
        {
            var lesson = ObjectMapper.Map<CreateLessonDTO, Lesson>(input);
            await _lessonRepository.InsertAsync(lesson);
        }
        catch (Exception ex)
        {
            throw;
        }
    }
}

修改后路由会变为/api/app/lesson/create，和/api/account/login格式一致。

方案二：修改方法名适配默认规则 #

将方法名从CreateLessonAsync改为CreateAsync，框架会自动将路由处理为/api/app/lesson（POST请求），更贴合RESTful风格：

public async Task CreateAsync(CreateLessonDTO input)
{
    try
    {
        var lesson = ObjectMapper.Map<CreateLessonDTO, Lesson>(input);
        await _lessonRepository.InsertAsync(lesson);
    }
    catch (Exception ex)
    {
        throw;
    }
}

方案三：全局配置路由模板 #

如果需要统一所有应用服务的路由格式，可以在模块的ConfigureServices方法中修改默认规则，比如直接使用方法名作为路由部分：

[DependsOn(typeof(AbpAspNetCoreMvcModule))]
public class YourModule : AbpModule
{
    public override void ConfigureServices(ServiceConfigurationContext context)
    {
        Configure<AbpAspNetCoreMvcOptions>(options =>
        {
            options.ConventionalControllers.Create(typeof(YourModule).Assembly, opts =>
            {
                // 自定义路由模板
                opts.Routing.RouteTemplate = "api/app/{controller}/{action}";
                // 移除方法名的Async后缀
                opts.Routing.RemoveAsyncSuffixFromActionName = true;
                // 路由转为小写短横线格式（可选）
                opts.Routing.UseLowerCaseRoutes = true;
            });
        });
    }
}

配置后CreateLessonAsync的路由会变为/api/app/lesson/create-lesson，和其他接口风格统一。

另外注意代码中的注释错误：//implement the IBookAppService应修正为//implement the ILessonService，避免混淆。

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