Orleans中Grain必须继承Grain类并实现以I开头、继承IGrain的公共接口，如public interface IUserGrain : IGrainWithIntegerKey；调用须通过IGrainFactory.GetGrain<T>(key)获取代理并await方法，激活由运行时自动管理，依赖正确配置的客户端与服务端。
Grain类必须继承Grain并实现接口
Orleans要求每个Grain类型是一个具体类，直接继承Grain（或泛型Grain<TState>），同时实现一个以I开头、继承IGrain的公共接口。接口定义方法签名，类提供实现——这是Orleans运行时定位和序列化调用的基础。
常见错误是只写类不定义接口，或接口未继承IGrain，此时GetGrain<T>()会编译失败或运行时报System.InvalidOperationException: Grain interface ... is not registered。
-
IUserGrain必须是public，且声明为public interface IUserGrain : IGrainWithIntegerKey - 对应实现类
UserGrain必须是public，并继承Grain与该接口：public class UserGrain : Grain, IUserGrain - 若使用持久化状态，改用
Grain<UserState>，并在OnActivateAsync中初始化State
通过IGrainFactory获取Grain引用并调用方法
Grain不能直接new，也不能跨silos传递实例。所有交互都通过逻辑引用完成：调用IGrainFactory.GetGrain<T>(key)返回一个轻量级代理对象，它封装了目标Grain的标识（类型+键）和通信逻辑。
这个代理是线程安全的，可缓存复用；调用其方法会自动触发激活（如果未激活）、路由、序列化和超时控制。
- 整数键：
var user = grainFactory.GetGrain<IUserGrain>(123); await user.UpdateName("Alice"); - 字符串键：
var tenant = grainFactory.GetGrain<ITenantGrain>("acme-inc"); - Guid键：
var order = grainFactory.GetGrain<IOrderGrain>(Guid.NewGuid());（需接口继承IGrainWithGuidKey） - 调用是异步的，务必
await，否则可能丢失异常或引发InvalidOperationException: Attempted to call a grain method without awaiting
Grain激活由Orleans运行时自动触发
你不需要手动“启动”或“注册”Grain实例。当第一次对某个key的Grain发起调用时，Orleans会在集群中选择一个silos，创建该Grain实例（调用OnActivateAsync），然后执行方法。实例在空闲超时（默认2分钟）后自动回收，下次调用再激活。
这意味着Grain类的构造函数不应含重逻辑或阻塞IO；所有初始化工作应放在OnActivateAsync中，并支持重复进入（例如检查State.IsInitialized）。
-
OnActivateAsync里可加载状态：await ReadStateAsync(); - 避免在其中
await外部HTTP/API调用——这会拖慢激活，影响整个silos吞吐 - 若需确保某Grain始终在线（如网关聚合器），可用
Reminder或Timer定期触发空方法维持激活
宿主项目必须正确配置Orleans客户端和服务端
Grain代码只是拼图一部分。没有正确的ISiloHost（服务端）和IClusterClient（客户端），GetGrain将无法解析地址或连接网关。
典型遗漏点：客户端没调用Connect()，或服务端没调用Build().StartAsync()；又或者UseLocalhostClustering()用于开发却忘了换为生产配置（如UseAdoNetClustering）。
- 服务端启动后，日志应出现
Started silo S127.0.0.1:11111；客户端连接成功会有Connected to gateway at 127.0.0.1:30000 - 客户端必须注入
IClusterClient，而非自己newClusterClient；推荐用AddOrleansClient+Configure<clusteroptions></clusteroptions> - Grain程序集需被服务端和客户端同时引用，且接口/类命名空间一致；否则序列化失败，报
SerializationException: Type ... not found
