如何通过PostSharp同时校验多API项目中控制器类名唯一性

我明白你的需求——在多命名空间的API解决方案里，自动检测不同程序集下是否存在同名的控制器类，而且不想给每个控制器加特性，只在AssemblyInfo里配置约束就行。你之前用ScalarConstraint没成功，是因为它主要针对单个目标类型做校验，没法跨程序集收集所有控制器信息来对比。下面给你一套可行的方案：

核心思路：用AssemblyLevelAspect做程序集层面的全局校验 #

我们需要创建一个程序集级别的切面，在编译时扫描所有API项目里的控制器类，收集它们的名称（只取类名，比如CatController），然后检查是否有重复。一旦发现重复，直接抛出编译错误。

具体实现步骤 #

1. 创建程序集级别的校验切面
   首先，新建一个类继承自AssemblyLevelAspect，并实现ICompileTimeValidate接口，代码如下：

using PostSharp.Aspects;
using PostSharp.Extensibility;
using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.AspNetCore.Mvc;

[MulticastAttributeUsage(MulticastTargets.Assembly)]
public class ControllerNameDuplicateCheck : AssemblyLevelAspect, ICompileTimeValidate
{
    // 存储所有已发现的控制器名称和对应的程序集信息
    private static readonly Dictionary<string, string> _controllerNames = new Dictionary<string, string>();

    public bool CompileTimeValidate(object target)
    {
        var assembly = (System.Reflection.Assembly)target;
        
        // 扫描当前程序集里所有的控制器类（这里以继承ControllerBase为例，适配ASP.NET Core）
        var controllers = assembly.GetTypes()
            .Where(t => !t.IsAbstract && typeof(ControllerBase).IsAssignableFrom(t));

        foreach (var controller in controllers)
        {
            var controllerName = controller.Name;
            
            // 检查是否已经存在同名控制器
            if (_controllerNames.TryGetValue(controllerName, out var existingAssembly))
            {
                // 抛出编译错误，提示重复的控制器名称和所在程序集
                Message.Write(
                    new MessageLocation(controller),
                    SeverityType.Error,
                    "CONTROLLER001",
                    $"控制器名称重复：{controllerName} 已在程序集 {existingAssembly} 中定义，当前程序集：{assembly.GetName().Name}"
                );
                return false;
            }
            else
            {
                _controllerNames.Add(controllerName, assembly.GetName().Name);
            }
        }

        return true;
    }
}

2. 在每个API项目的AssemblyInfo中引用约束
   把这个切面所在的项目引用到所有API项目里，然后在每个API项目的AssemblyInfo.cs文件中添加以下代码：

[assembly: ControllerNameDuplicateCheck]

关键细节说明 #

• 控制器识别逻辑：上面的代码用typeof(ControllerBase).IsAssignableFrom(t)判断控制器，如果你是ASP.NET Framework项目，可以换成typeof(System.Web.Mvc.Controller)；如果你的控制器都以Controller后缀命名，也可以用controller.Name.EndsWith("Controller")来判断，更灵活。
• 跨程序集全局收集：静态字典_controllerNames会在整个编译过程中保持状态，能收集到所有API项目里的控制器名称，实现跨程序集的重复校验。
• 错误提示：通过Message.Write抛出的编译错误，会直接显示在Visual Studio的错误列表中，方便快速定位问题。

替代思路：用IAspectProvider动态添加校验逻辑 #

如果你更倾向于类似ScalarConstraint的实现方式，也可以通过IAspectProvider给每个控制器动态添加校验切面，再在切面里共享全局名称集合。不过上面的程序集级别方案更直接高效，不需要给每个控制器动态附加特性。

这样配置后，只要你在任何API项目里新增了和其他项目同名的控制器，编译时PostSharp就会立刻抛出错误，完全符合你的需求。

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