TestStand运行时TestSockets.MyIndex返回-1的原因

RunState.TestSockets.MyIndex返回-1的核心含义是：当前执行表达式的线程不属于批量模型分配的UUT测试套接字线程，和batchmodel.seq文件本身损坏无关，不用尝试重装TestStand或者修复官方模型文件，按以下优先级排查即可：

高概率触发原因（匹配「近期突然出现、未修改官方模型」特征） #

• 表达式上下文错配
  在ReportOptions中配置调用该变量的路径生成表达式是最常见的踩坑点：Batch模型的执行线程分两类，一类是负责调度的批量控制主线程，一类是每个UUT对应的测试套接字线程。主线程执行全局报告配置加载、批量汇总报告生成、批量级回调逻辑时，本身不绑定任何测试套接字，MyIndex固定返回-1。
  之前运行稳定大概率是早期版本的路径表达式绑定在单UUT报告生成的回调上下文中，近期如果调整过ReportOptions的配置，把路径表达式挪到了批量汇总报告的配置项、或者全局报告初始化的配置节点上，就会直接触发该错误。

  快速验证：把路径表达式里的RunState.TestSockets.MyIndex临时替换为RunState.TestSockets.MyIndex < 0 ? 99 : RunState.TestSockets.MyIndex，跑双UUT测试，如果生成3个路径（1个带99的批量路径、2个分别带0和1的单UUT路径），即可确认是表达式配置的上下文错配，把单UUT的路径表达式移回单UUT报告配置节点即可。

• 套接字数量覆盖逻辑执行时机错误
  通过ModelOptions.seq里的Parameters.ModelOptions.NumTestSockets = 2覆盖默认4套接字的配置时，如果这个赋值语句的位置在模型套接字初始化步骤之后，批量模型会先按默认值创建4个套接字槽位，后续修改套接字数量不会重新绑定线程和槽位的映射关系，未分配到有效槽位的线程读取MyIndex时就会返回-1。

  快速验证：直接把TestStand Station Options里的默认测试套接字数量改成2，注释掉ModelOptions里的覆盖语句跑一次测试，如果MyIndex能正常返回0/1，就说明是赋值时机不对，把该赋值语句移到ModelOptions序列的第一个步骤，保证在所有模型初始化逻辑之前执行即可。

• 批量级回调误调用
  如果近期给PreBatch、PostBatch、BatchSummary这类批量级回调加了访问testInfo[]/uutInfo[]数组的逻辑，这类回调全程跑在批量控制主线程，没有绑定套接字，调用MyIndex必然返回-1，把这类数组访问逻辑移到单UUT级的PreUUT/PostUUT回调里即可。

临时兜底方案 #

排查阶段可以先给所有调用MyIndex的位置加边界判断，避免测试流程直接崩溃：

Locals.SocketIndex = RunState.TestSockets.MyIndex >= 0 ? RunState.TestSockets.MyIndex : 0

注意这个只是防崩溃的兜底逻辑，不能替代根因修复——双UUT测试时必须确认两个UUT线程分别拿到0和1的索引，避免两个UUT生成相同路径覆盖报告文件。

排查顺序 #

1. 先核对ReportOptions中路径表达式绑定的配置节点，区分单UUT报告和批量汇总报告的配置边界
2. 再核对ModelOptions中套接字数量赋值语句的执行位置
3. 最后排查所有批量级回调中的索引调用逻辑

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