将自定义类移至外部Assembly后调用CreateInstance()触发InvalidCastException

这种跨程序集类型转换的坑我之前也踩过！你遇到的InvalidCastException本质上是CLR的类型标识规则导致的——即使两个类的代码完全一致，只要它们来自不同的程序集，CLR就会将它们视为完全不同的类型。下面我分几种常见情况给你分析解决方案：

1. 核心问题：重复定义的类型导致不兼容 #

如果你的主程序集里还保留了原来的自定义类代码，或者外部DLL和主程序集各自定义了同名同结构的类，那必然会出现转换失败。

解决办法： #

把所有自定义类型的抽象定义（接口或抽象基类）抽成一个独立的共享类库，比如MyCustomTypes.Abstractions。然后：

• 主程序集引用这个共享类库，只依赖抽象定义
• 外部DLL也引用这个共享类库，让所有自定义类实现该接口/继承该基类
  这样无论实例来自哪个程序集，只要实现了共享的抽象，就能安全转换。

2. 程序集加载方式导致的重复加载 #

如果你的代码用Assembly.LoadFrom或Assembly.LoadFile加载外部DLL，可能会因为加载上下文的问题，导致同一个DLL被多次加载（比如不同路径下的同名DLL），进而产生重复的类型。

解决办法： #

• 优先使用Assembly.Load(程序集名称)，让CLR的程序集绑定机制来处理加载，避免手动加载带来的上下文问题
• 如果必须用文件路径加载，确保每次加载的是同一个物理文件，并且可以缓存加载后的Assembly实例，避免重复加载
• 可以注册AppDomain.CurrentDomain.AssemblyResolve事件，统一处理程序集加载逻辑，确保同标识的程序集只被加载一次

3. 类型转换的写法错误 #

很多时候问题出在转换的目标类型上：如果你直接把Activator.CreateInstance返回的object强制转换成主程序集里的具体类，而外部DLL的类并不是这个具体类的实例（只是同名），自然会抛异常。

正确的转换写法： #

假设共享类库中有接口ICustomType，外部DLL的类MyCustomImpl实现了这个接口：

// 正确：转换为共享接口
ICustomType instance = (ICustomType)Activator.CreateInstance(targetType);

// 错误：转换为主程序集的具体类（除非外部DLL的类确实继承自这个类）
MyCustomType instance = (MyCustomType)Activator.CreateInstance(targetType);

4. 强名称程序集的版本/签名不匹配 #

如果你的主程序集是强名称签名的，而外部DLL没有签名，或者两者的强名称公钥、版本号不一致，CLR会认为它们的类型属于不同的“命名空间”，导致转换失败。

解决办法： #

• 确保所有相关的程序集（共享类库、外部DLL）都使用相同的强名称密钥对签名
• 如果版本不一致，可以在配置文件中添加<bindingRedirect>来统一版本，或者确保所有程序集使用相同的版本号

快速排查步骤 #

1. 检查外部DLL中的自定义类是否正确实现了主程序集能访问的共享接口/基类
2. 确认共享类库在主程序集和外部DLL中的引用版本完全一致
3. 检查加载外部DLL的代码是否存在重复加载的情况
4. 验证所有相关程序集的强名称签名（如果使用的话）是否一致

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