升级至SaltStack 3006.1后出现JSON Decoder Error求助

问题背景 #

我们有一段在SaltStack 3004.2版本中运行正常的配置代码，升级至3006.1版本后，代码中标注的Address行抛出json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)错误，无法定位问题根源，需判断是代码适配问题还是依赖/版本兼容性问题。

原运行正常的代码片段 #

---
[...]
    {% elif network == 'sfe' %}
        [Link]
        MTUBytes={{ pillar['storage']['sfe_mtu'] }}
        [Network]
        DHCP=no
        Address={{ salt['address.client_get_address']('api', pillar['api']['user_password'], network, grains['host']) }}/{{ pillar['networking']['subnets'][network].split('/')[1] }}    <======================
    {% elif network == 'sbe' %}
        [Link]
        MTUBytes={{ pillar['storage']['sbe_mtu'] }}
        [Network]
        DHCP=no
[...]
---

升级后触发的错误 #

json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)

环境信息 #

Salt Version:
          Salt: 3006.1

Python Version:
        Python: 3.10.11 (main, May  5 2023, 02:31:54) [GCC 11.2.0]

Dependency Versions:
          cffi: 1.14.6
      cherrypy: unknown
      dateutil: 2.8.1
     docker-py: 1.10.6
         gitdb: 4.0.10
     gitpython: 3.1.31
        Jinja2: 3.1.2
       libgit2: 1.6.4
  looseversion: 1.0.2
      M2Crypto: 0.38.0
          Mako: 1.2.4
       msgpack: 1.0.2
  msgpack-pure: Not Installed
  mysql-python: Not Installed
     packaging: 22.0
     pycparser: 2.21
      pycrypto: 3.18.0
  pycryptodome: 3.9.8
        pygit2: 1.12.1
  python-gnupg: 0.4.8
        PyYAML: 5.4.1
         PyZMQ: 23.2.0
        relenv: 0.12.3
         smmap: 5.0.0
       timelib: 0.2.4
       Tornado: 4.5.3
           ZMQ: 4.3.4

System Versions:
          dist: debian 10 buster
        locale: utf-8
       machine: x86_64
       release: 4.19.0-24-cloud-amd64
        system: Linux
       version: Debian GNU/Linux 10 buster

排查方向与解决方案 #

1. 核心问题定位 #

该JSON解码错误的本质是：salt['address.client_get_address']模块执行后返回了空值或非JSON格式内容。SaltStack 3006.x版本对模块返回值的JSON解析逻辑做了严格校验，而3004.2版本对空返回或非标准JSON的兼容性更强，因此新版本直接抛出解码错误。

2. 代码适配调整 #

• 先验证模块返回结果：在minion节点执行以下命令，单独测试模块的返回值是否符合预期：

  salt-call address.client_get_address 'api' '<your_password>' 'sfe' '<target_host>'
  

  检查返回是否为有效IP地址或可JSON序列化的数据。
• 增加容错逻辑：避免空值导致模板渲染失败，可修改代码如下：

  {% set addr = salt['address.client_get_address']('api', pillar['api']['user_password'], network, grains['host']) %}
  {% if addr %}
  Address={{ addr }}/{{ pillar['networking']['subnets'][network].split('/')[1] }}
  {% else %}
  # 此处可添加空地址的 fallback 逻辑，比如使用默认IP或抛出明确错误
  Address=0.0.0.0/{{ pillar['networking']['subnets'][network].split('/')[1] }}
  {% endif %}
  

• 校验参数有效性：确认pillar['api']['user_password']、grains['host']在新版本中的值是否符合模块要求，部分pillar/grains的加载逻辑在3006版本中存在细微调整。

3. 依赖与版本兼容性检查 #

• 自定义模块兼容性：若address是自定义模块，需检查其是否适配3006.1版本——新版本要求模块必须返回可JSON序列化的数据，若模块返回非标准格式会触发解码错误。
• Python版本适配：3006.1使用Python 3.10，而3004.2通常使用Python 3.7/3.8，需检查address模块中是否存在Python版本相关的语法或库调用差异。
• PyYAML版本验证：当前环境PyYAML为5.4.1，尝试升级至SaltStack 3006.x推荐的6.0版本测试：

  pip install --upgrade PyYAML==6.0
  

内容的提问来源于stack exchange，提问作者Javier Diaz Charles