AnyLogic中调用store()函数存储智能体到单元格时为何报错？

问题重现 #

尝试通过代码创建Agent1类型智能体并存储到MHL的Storage中：

Agent1 a = new Agent1();
StorageCell cell = storage.getRandomFreeCell();
cell.store(a);

代码编译正常，前两行可执行，但第三行抛出以下错误：

java.lang.NullPointerException

    at com.anylogic.engine.Utilities.time(Unknown Source)

    at com.anylogic.libraries.processmodeling.ExtEntityImpl.<init>(Unknown Source)

    at com.anylogic.libraries.processmodeling.ExtEntityImpl$1.a(Unknown Source)

    at com.anylogic.libraries.processmodeling.ExtEntityImpl$1.create(Unknown Source)

    at com.anylogic.engine.Agent.c(Unknown Source)

    at com.anylogic.engine.Agent.c(Unknown Source)

    at com.anylogic.engine.ExtAgentWithSpatialMetricsDelegate.e(Unknown Source)

    at com.anylogic.engine.ExtEntityDelegate.getColor(Unknown Source)

    at com.anylogic.engine.Agent.getColor(Unknown Source)

改用直接调用storage.store()方法仍出现相同错误：

Agent1 a = new Agent1();
storage.store(a);

问题原因 #

从错误栈追踪可以看出，异常根源是com.anylogic.engine.Utilities.time()抛出空指针，这说明直接通过new Agent1()创建的Agent实例没有正确关联到AnyLogic的模型上下文（缺少对引擎、时间管理等核心对象的引用）。AnyLogic的Agent类依赖模型上下文才能正常初始化内部属性（比如颜色、空间坐标等），直接实例化会导致后续调用这些依赖上下文的方法时触发空指针异常。

解决方案 #

必须使用AnyLogic提供的正确方式创建Agent，确保实例关联到模型上下文：

方式1：使用自动生成的工厂方法 #

AnyLogic会为每个自定义Agent类自动生成create_<Agent类名>()方法，调用该方法会自动完成上下文绑定：

Agent1 a = create_Agent1();
storage.store(a);

方式2：传入上下文参数的构造函数 #

如果需要手动传入上下文，可使用带Agent上下文参数的构造函数（参数为当前所在的Agent实例，比如Main模型或者其他子Agent）：

Agent1 a = new Agent1(this); // this代表当前Agent上下文
storage.store(a);

非Agent类中创建的情况 #

如果是在普通Java类而非Agent类中创建Agent，需要传入模型的Main实例作为上下文：

Agent1 a = new Agent1(main); // main为模型的Main实例引用
storage.store(a);

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