Jenkins Job DSL插件处理Emoji代码点异常问题问询

问题现象 #

使用Jenkins Job-DSL插件创建显示名包含火箭Emoji（🚀）的任务时，无论直接写UTF-8 Emoji序列（"+02 🚀 Release"）还是用UTF-16代理对转义（"\uD83D\uDE80 Release"），脚本内打印检查字符串编码完全正确，但任务生成后，火箭Emoji被截断为无效的0xF680代码点。而通过Jenkins Web UI手动创建同样显示名的任务却能正常显示。

环境信息：

• 系统：Windows
• Jenkins版本：2.263.4
• Job-DSL插件版本：1.76

相关Job-DSL代码：

freeStyleJob(...) {
  ...
  final def disp_name = "+02 🚀 Release" // 直接使用UTF-8 Emoji
  // final def disp_name = "\uD83D\uDE80 Release" // UTF-16代理对转义写法
  displayName(disp_name)
...

字符串编码检查代码（执行后显示编码正确）：

println "job has display_name: $disp_name"
for (int i=0; i<disp_name.length(); ++i) {
    println(sprintf("i $i %08X vs. %04X", java.lang.Character.codePointAt(disp_name, i), (int)disp_name.charAt(i)))
}

问题分析 #

火箭Emoji属于UTF-16补充平面字符，需要用代理对（U+D83D + U+DE80）表示，占两个16位字符。推测问题出在Job-DSL插件将Groovy字符串传递给Jenkins内部API的过程中，字符串被错误地按单16位字符截断或编码转换，导致代理对丢失高位信息，最终生成无效的0xF680代码点。而Web UI创建时，Jenkins直接处理完整的UTF-8/UTF-16字符，不会出现截断。

解决方案尝试 #

1. 显式通过代码点构造字符串
   绕过可能的编码转换步骤，直接用Unicode代码点构造Emoji字符串：

   // 用火箭Emoji的Unicode代码点（U+1F680）构造字符串
   final def rocket = new String(new int[]{0x1F680}, 0, 1)
   final def disp_name = "+02 ${rocket} Release"
   displayName(disp_name)
   

2. 升级Job-DSL插件版本
   Job-DSL 1.76是2020年的旧版本，后续版本大概率修复了Unicode字符传递的bug。可尝试升级到与Jenkins 2.263.4兼容的最新版本（需参考插件兼容性矩阵）。

3. 通过configure块直接操作Jenkins配置
   绕过Job-DSL的displayName方法，直接修改Jenkins内部配置模型，避免插件层的编码处理：

   freeStyleJob(...) {
     ...
     configure { project ->
       project / displayName "+02 🚀 Release"
     }
   }
   

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