材料建好了，CAE 却死了：一类有据可查的闪退

01三个错误签名：SEGMENTATION FAULT、ipc_TOO_LITTLE_SENT、WSAENOTSOCK

插件帮助文档的报错对照表里，这一类现象作为整行收录，原文是：

CAE 闪退 / SEGMENTATION FAULT in ABQcaeG
        / ipc_TOO_LITTLE_SENT / WSAENOTSOCK

三个串通常前后脚出现，各自的含义只到这个程度：

• ABQcaeG 是 CAE 图形界面进程的名字，SEGMENTATION FAULT 说明 死的是界面进程；
• ipc_TOO_LITTLE_SENT 和 WSAENOTSOCK 出现在进程退出阶段，是界面进程与 Abaqus 内核进程之间的通信（套接字） 已经拆掉时的报错。

插件 README 的 1.2 更新日志把这三个串并列为同一个缺陷的签名， 而不是三个独立故障 —— 所以看到它们不要去查网络设置，先看时间线： 点导入、材料建成、汇总提示出现、然后进程消失。

02先止损：材料在崩溃之前就已经建好了

README 1.2 节对现象的原话描述是「材料已经正确建好了， 紧接着 CAE 却报 SEGMENTATION FAULT / ipc_TOO_LITTLE_SENT / WSAENOTSOCK 并退出」。所以第一步永远是：

1. 重新打开 CAE，再打开那个 .cae 文件，到 Property 模块看材料列表 —— 材料都在，不用重做；
2. 打开 abaqus.rpy 日志，会看到导入命令是完整的。 这不是日志写错了：内核侧命令确实已经成功执行， 崩在更晚的界面退栈阶段，插件源码注释里专门记了这一句 ——「after the import command itself had already succeeded, which is why abaqus.rpy looked complete」；
3. 不要原样再点一次导入。材料已在，再导一次只会得到skipped, already present 的跳过行。

还有一种东西可能留在模型里：名叫 zzMaterialImporterScratch0 的材料。那是覆盖同名材料时的临时名 —— 新版本先把新材料建在临时名下， 确认成功才改名换上去。看到它残留，说明那一次替换没有走完， 而模型里原来那份材料是完好的，直接删掉这个临时材料即可。 这条的完整说明在帮助文档的报错原因对照表。

03根因：模态框开在了表单提交事务内部

CAE 插件的表单提交走 AFXForm 的提交流程， 表单的自定义检查（doCustomChecks）运行在一个提交事务里。1.1 版本的插件在材料全部建好之后， 会弹一个汇总对话框（哪些材料缺了哪块属性）。问题出在这个框的位置：

点「导入」
  → doCustomChecks 在提交事务内执行
    → 内核把材料一条条建好（命令成功）
      → 弹出模态汇总框
        → 模态框开启嵌套事件循环
          → 提交事务不可重入，退栈时段错误
            → ABQcaeG 带着三个签名退出

README 1.2 的归纳是：「模态框会开启嵌套事件循环，而提交事务不可重入， 退栈时就崩了」。1.2 的修法也由此确定 —— 汇总信息一律输出到 CAE 主窗口下方的消息区（Message area）， 可滚动、可复制，不再弹任何框。1.2 起点导入什么框都不弹， 不是 bug，是刻意的设计。

为什么数据报错反而不崩

插件把两类问题分得很开。材料数据有问题（弹性模量为负、塑性表起点不为零 这类）时，内核命令直接抛 ValueError： 这次导入中止，半成品材料被删掉，消息区留一行 FAILED 材料名: 原因，模型保持干净。 内核源码开头的注释把 Abaqus 的脾气写得很明白： 物理上不可能的材料数据，CAE 建材料时一句抱怨都没有， 一个负模量要拖到很久之后，求解器才以晦涩的方式中止。 也就是说，能以 FAILED 文案拦住的问题都不会闪退， 闪退只来自界面层的事件循环。

04插件记录在案的第二个同类坑：多主窗口

同一个项目里还有第二个有据可查的 CAE 段错误，发生得更早 —— 在插件注册阶段，连菜单都还没点。

早期版本为了探测界面能不能显示中文，临时创建过一个 FXMainWindow 来测量字符串。源码注释记录了后果： 这个临时主窗口撞上了 Abaqus 自己的「creating multiple main windows」 保护路径，CAE 在插件注册期间就段错误退出。 现在的探测改用 AFXStringKeyword —— 它只是一个关键字对象，经过同样的字符串绑定但不拥有任何窗口。

05自己写 CAE 界面脚本时的四条规矩

如果你也用 Abaqus GUI 工具包写自己的插件和表单， 这四条规矩在插件源码注释里被反复强调，全部来自上面两次真事故：

1. 在 doCustomChecks 里拒绝输入，只能一口气做完。 文档化的方式是 showAFXErrorDialog(...) 之后立刻 return False，对话框和返回之间一行别的代码都不要加；
2. 绝不能「弹个框，然后继续往下执行」。 源码原话说，一个被留在执行路径上的对话框，会在提交事务退栈时让 CAE 段错误 —— 框本身合法，错在它出现的位置；
3. 批量结果走内核 print() 输出到消息区， 不要给 N 个材料弹 N 个框。消息区可滚动、可复制， 用户还能存成文本，体验比排队关框好得多；
4. 永远不要自己 new 一个 FXMainWindow。 要探测界面能力，用不拥有窗口的关键字对象。

插件里的「材料健康检查」就是这套规矩的样板：它注册为内核菜单按钮 （registerKernelMenuButton），点击后直接执行内核命令， 源码注释的原话是「no GUI dialog, so no crash risk」—— 没有界面对话框，就没有这一类崩溃面。 想在自己的脚本里批量建材料、又不想碰界面事务， 走纯内核脚本是最省心的路线，写法见用 Python 批量建材料。

06升级、确认环境、验证修好了

这个缺陷属于 1.1 的已知问题，1.2 已修复。收尾三步：

1. 覆盖安装：关闭 CAE，重新跑一遍 install.bat 直接覆盖。README 明确写了激活记录不会丢， 不需要重新激活；
2. 确认菜单里只有一个「材料库」。 插件装在两个目录时两份都会被加载，菜单出现两次， 实际跑的可能正是旧目录里那份 1.1。安装位置和旧副本清理见插件安装路径和帮助文档安装一节；
3. 验证整条链是通的：菜单 Plug-ins → 材料库 → 材料健康检查。它不要求登录、不要求授权、不联网， 能在消息区跑出一份检查报告，说明目录发现、菜单注册、内核初始化整条链都正常。 报告怎么读，见交付前材料自查清单。

如果没用插件、手动在 Property 模块建材料也闪退

这篇记录的机制发生在插件表单的提交事务里， 手动在 Property 模块填表不经过它。可以这样区分：把插件目录改名移走后 完全重启 CAE，再手动建一次材料。还崩，问题就与插件无关； 不崩了，多半是加载了旧版本插件副本。另外记住一个判据： 材料数值本身的问题从来不会以 GUI 闪退的形式出现 —— CAE 对材料数据照单全收，数值错误的暴露位置在求解期。