Grails 3.3.5中-Dfile.encoding=UTF-8参数失效问题求助

我之前也碰到过一模一样的问题，Grails的命令行包装器确实不会默认把所有系统属性都传递给底层的Gradle进程，导致你直接加-Dfile.encoding=UTF-8在grails命令后面没效果。这里有几个靠谱的解决办法，按优先级推荐：

1. 用--gradle-option直接传递参数给Gradle #

这是最直接的临时解决方案，不用改任何配置文件，只需要在执行Grails命令时加上这个参数，把编码属性直接传给Gradle：

grails --gradle-option="-Dfile.encoding=UTF-8" war

这个参数的作用就是把后面的选项原封不动传递给底层启动的Gradle进程，确保编码属性被Gradle接收到。

2. 设置GRAILS_OPTS环境变量 #

如果不想每次都加长长的参数，可以设置环境变量让Grails启动时自动带上这个属性：

• Linux/macOS：在终端执行

  export GRAILS_OPTS="-Dfile.encoding=UTF-8"
  

  之后再执行grails war就会自动传递编码属性了。如果想永久生效，可以把这行加到你的~/.bashrc、~/.zshrc或者对应的shell配置文件里。
• Windows：在命令提示符里执行

  set GRAILS_OPTS=-Dfile.encoding=UTF-8
  

  或者在系统环境变量里添加GRAILS_OPTS变量，值设为-Dfile.encoding=UTF-8。

3. 在项目build.gradle中硬编码编码配置（一劳永逸） #

如果希望项目不管用什么命令构建都统一用UTF-8编码，直接在项目根目录的build.gradle里添加以下配置：

// 配置Java编译编码
tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
}

// 配置Groovy编译编码（Grails项目常用Groovy）
tasks.withType(GroovyCompile) {
    groovyOptions.encoding = 'UTF-8'
}

// 配置War打包时的文件编码
war {
    webInf {
        from('src/main/webapp/WEB-INF') {
            include '*.xml'
            filteringCharset = 'UTF-8'
        }
    }
}

这样不管你用grails war还是gradle assemble，所有编译和打包环节都会使用UTF-8编码，彻底解决编码问题。

为什么会出现这个问题？ #

Grails命令本质是一个JVM包装器，它先启动自己的JVM进程处理Grails相关逻辑，然后再启动Gradle进程执行构建任务。默认情况下，Grails只会传递少数和自身相关的系统属性给Gradle，而file.encoding这类通用属性不在默认传递列表里，所以直接加在grails命令后面的-D参数不会被Gradle接收到，而用上面的方法就能强制传递或者直接在Gradle层面配置编码。

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