命令行运行测试时Allure结果未写入，抛出AllureResultsWriteException异常

命令行执行测试时抛出异常如下：

SEVERE: Exception while executing pickle
java.util.concurrent.ExecutionException: io.qameta.allure.AllureResultsWriteException: Could not write Allure test result

注：报错中executing pickle说明该问题出在Cucumber系列测试框架执行用例步骤的阶段

• 结果目录权限不足：运行测试的系统用户对配置的Allure结果输出目录无读写、创建文件权限，常见于Linux/macOS环境下曾用root权限执行命令生成过结果目录，后续普通用户运行时无法写入
• 结果目录被锁定：Allure实时预览服务、未正常退出的历史测试进程、杀毒/文件同步类工具正在占用结果目录内的文件，写入请求被系统拦截
• 存储异常：结果目录所在磁盘分区剩余空间耗尽，无法写入新的结果文件
• 路径配置非法：命令行传入的结果目录路径包含系统不兼容的特殊字符、中文、空格，或指向多层不存在的嵌套目录且程序无自动创建父目录权限，相对路径跨盘符解析失败
• 依赖版本冲突：项目内Allure适配器（如allure-cucumber-jvm、allure-junit、allure-testng）版本与本地Allure命令行版本不匹配，或多版本Allure依赖共存，导致测试结果序列化失败无法落盘
• 并发写入冲突：测试并发数设置过高，多线程/多进程同时尝试写入同一个结果文件，文件锁竞争失败触发异常

• 校验目录权限
  执行测试前先手动删除旧的allure-results目录，避免历史权限残留。手动执行touch <你配置的Allure结果目录绝对路径>/test.txt验证写入权限：
  • Linux/macOS环境如果提示权限错误，执行sudo chmod -R 755 <结果目录路径>、sudo chown -R <当前运行测试的用户名>:<用户所属组> <结果目录路径>修复权限
  • Windows环境右键结果目录，打开「属性-安全」面板，给当前运行测试的用户勾选「完全控制」权限后保存
• 解除目录占用
  执行测试前关闭所有正在运行的allure serve、allure open预览进程，这类进程会实时读取结果目录极易触发文件锁定：
  • Linux/macOS环境执行lsof | grep allure-results找到占用结果目录的进程ID，执行kill -9 <进程ID>释放占用
  • Windows环境打开资源监视器，搜索关联文件句柄关闭对应占用进程，临时关闭杀毒、云盘同步类工具再重试
• 校验存储与路径配置
  执行df -h（Linux/macOS）或直接查看目标磁盘属性（Windows）确认分区剩余空间，空间不足时清理冗余文件即可。命令行指定结果目录时尽量使用无中文、无特殊字符的绝对路径，Java类项目可通过-Dallure.results.directory=<绝对路径>明确指定输出位置，提前手动创建路径下所有父目录避免解析错误
• 修复依赖冲突
  统一项目内所有Allure相关依赖的版本，保证Allure适配器版本和本地安装的Allure命令行大版本完全一致（比如统一使用2.24.x版本），避免跨大版本的序列化兼容问题。由于报错出在Cucumber执行阶段，重点校验allure-cucumber-jvm版本和项目引入的Cucumber核心依赖版本的匹配关系，版本不兼容会直接导致步骤结果序列化失败
• 解决并发写入冲突
  高并发场景下适当降低测试并发数，或给分布式执行的各个节点配置独立的本地结果输出目录，等所有节点执行完成后，再把所有节点的结果文件汇总到同一个目录下生成报告，避免多进程同时写入同一目录产生锁冲突

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