Ansible集群项目更新失败：数据库存储作业事件遇NUL字符错误

这个错误的核心是Ansible AWX在保存项目更新事件到数据库时，事件数据中包含了二进制空字符（0x00），而数据库（由Django底层操作）禁止字符串字面量包含这类字符。重启服务器只是临时清空了缓存的错误数据，并没有解决根本问题。

• 定位含空字符的数据源：
  1. 检查项目代码仓库中的文件，用命令扫描空字符：

     grep -r "\x00" /path/to/your/project/repository
     

     重点关注二进制文件、自动生成的配置文件、日志导出文件。
  2. 检查Ansible Playbook中的模块输出：比如shell/command模块执行的命令是否返回了带空字符的结果，或者fetch模块拉取了含空字符的远程文件。
  3. 排查自定义回调插件：如果使用了自定义AWX回调插件，检查是否在处理事件数据时意外引入了空字符。

1. 清理含空字符的文件：
   如果在代码仓库中找到带空字符的文件，直接删除或修复（比如重新生成配置文件，避免写入空字符）。
2. 过滤Playbook输出中的空字符：
   对返回空字符的命令添加过滤逻辑，用sed去除空字符：

   - name: 执行命令并过滤空字符
     shell: your-target-command | sed 's/\x00//g'
     register: filtered_output
   

3. 清理AWX脏数据：
   如果是AWX缓存的事件数据导致的重复报错，手动清理相关数据（操作前请备份数据库）：

   # 容器化部署的AWX，进入task容器
   docker exec -it awx_task bash
   # 清除Django缓存
   python manage.py clear_cache
   # 删除含空字符的项目更新事件
   python manage.py shell -c "from awx.main.models import ProjectUpdateEvent; ProjectUpdateEvent.objects.filter(stdout__contains='\x00').delete()"
   

4. 升级AWX版本：
   部分旧版AWX存在特殊字符处理的bug，升级到最新稳定版可能直接修复该问题。

• 在代码仓库添加预提交钩子，禁止含空字符的文件提交。
• 对Playbook中所有外部命令的输出统一做字符过滤，避免特殊字符流入AWX事件系统。
• 定期检查callback-receiver.log日志，及时发现类似字符编码问题。

内容的提问来源于stack exchange，提问作者Aman Anand