Serenity 4.x.x版本解析含Unicode字符特性文件失败求助

API 探路者

2026-6-15

解决Serenity 4.x.x升级后UTF-8特性文件读取失败问题

针对升级Serenity到4.x.x后含非ASCII字符的UTF-8特性文件无法读取的问题，可尝试以下几种解决方案：

明确指定Serenity特性文件编码
在项目的serenity.properties配置文件中添加以下配置，强制Serenity以UTF-8编码读取特性文件：
```
serenity.feature.file.encoding=UTF-8
```
若使用serenity.conf（基于Typesafe Config），则添加：
```
serenity {
  feature {
    file {
      encoding = "UTF-8"
    }
  }
}
```
确保特性文件为UTF-8无BOM格式
部分文本编辑器保存UTF-8文件时会自动添加BOM（字节顺序标记），Java对带BOM的UTF-8文件读取可能出现异常。用文本编辑器（如Notepad++、VS Code）打开特性文件，将编码转换为UTF-8无BOM格式后重新保存。
设置JVM默认编码为UTF-8
在测试运行的JVM参数中添加-Dfile.encoding=UTF-8，确保整个JVM环境以UTF-8处理文件读取。如果是用Maven运行测试，可在pom.xml的maven-surefire-plugin中配置：
```
<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <configuration>
    <argLine>-Dfile.encoding=UTF-8</argLine>
  </configuration>
</plugin>
```
若是Gradle，则在build.gradle中添加：
```
test {
  jvmArgs '-Dfile.encoding=UTF-8'
}
```

检查Cucumber依赖的编码配置
若项目使用Cucumber与Serenity集成，可在Cucumber配置类中明确指定特性文件编码：

@CucumberOptions(
  features = "src/test/resources/features",
  glue = "your.step.definitions.package",
  encoding = "UTF-8"
)
public class CucumberTestSuite {}