Azure DevOps中ARM参数JSON渲染报双引号属性名错误排查

可能的问题原因 #

• 隐藏非法字符或格式不规范：生成的JSON文件位置2312附近存在非标准字符（如全角引号、BOM头、控制字符），或者属性名使用了单引号/未加引号，违反JSON必须用双引号包裹属性名的规则。
• PowerShell序列化缺陷：脚本使用ConvertTo-Json时未指定足够的深度参数（默认深度2），导致嵌套对象被截断或格式错乱；或合并逻辑中手动拼接JSON字符串时出现语法错误。
• 占位符替换不彻底：模板中的占位符（如{{ipFilter}}）替换后，值中包含未转义的双引号、换行符等，破坏了JSON结构的完整性。

解决办法（无需修改流水线/脚本） #

1. 精准定位错误点
   • 复制生成的azuredeploy.parameters.<env>.json内容到JSON校验工具（如本地VS Code的JSON校验功能），直接跳转到位置2312，查看对应的属性或值，确认具体错误类型（比如属性名缺双引号、值未转义）。
2. 修正模板文件
   • 打开azuredeploy.parameters.json.template，检查对应位置的JSON结构：确保所有属性名都用双引号包裹，避免使用单引号或无引号；确认占位符的位置不会破坏JSON语法（比如不要在属性名里放占位符）。
3. 清理环境特定值
   • 检查环境值文件中对应ipFilter等参数的内容：如果值包含双引号，必须转义为\"；如果有换行符，转义为\n；删除全角空格、中文标点等非ASCII字符。
4. 移除不可见字符
   • 用VS Code打开生成的JSON文件，开启「显示控制字符」功能（右下角状态栏点击「CRLF」旁的选项，勾选「Render Control Characters」），删除BOM头、空控制字符等。
5. 临时手动修复生成文件
   • 若上述方法无法解决，可手动修正生成的azuredeploy.parameters.<env>.json文件，替换流水线中自动生成的文件（需确保权限允许）。

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