## 能解析，不代表能直接执行

把脚本参数放进 JSON 文件后，一个常见做法是读入字典，再逐项传给业务函数。这样省去了命令行里不断输入参数的麻烦，但也把问题推迟到了运行阶段：开关被写成字符串、批次数量写成布尔值，或者同一字段在文件中出现了两次，都会让配置含义变得模糊。

下面以一个只包含 enabled 和 batch_size 的批处理配置为例，建立三个边界：文件能够按预期解析；字段名和类型符合约定；取值落在本程序允许的范围。这是小型脚本的输入检查示例，不是一套通用配置框架。

## 先写下字段契约

字段
本例允许的类型
本例允许的值

enabled
布尔值
true 或 false

batch_size
整数
1 到 1000，包含两端

这里的上限 1000 只是示例程序的约束，实际应由任务耗时、内存占用和下游处理能力确定。未知字段也选择拒绝：对于只有两个参数的小工具，拼错字段时立即停止，比悄悄忽略后按默认值运行更容易排查。

![配置检查的三个层次：解析、字段与范围](https://developer.qcloudimg.com/http-save/10037525/1f813806cb54408eeb49384e15a7a8e5.jpg)

## 把检查集中在加载入口

下面的函数只返回通过检查的字典。它不读取环境变量、不自动纠正输入，也不开始任何业务任务。使用者先处理读取错误，再把文本交给该函数；调用端只有在函数正常返回后，才能进入后续批处理。

```
import json

def unique_object(pairs):
    result = {}
    for key, value in pairs:
        if key in result:
            raise ValueError(f"duplicate key: {key}")
        result[key] = value
    return result

def reject_constant(value):
    raise ValueError(f"non-finite constant: {value}")

def read_settings(text):
    data = json.loads(text, object_pairs_hook=unique_object,
                      parse_constant=reject_constant)
    if not isinstance(data, dict):
        raise ValueError("root must be an object")
    if set(data) != {"enabled", "batch_size"}:
        raise ValueError("unexpected or missing fields")
    if type(data["enabled"]) is not bool:
        raise ValueError("enabled must be a boolean")
    if type(data["batch_size"]) is not int:
        raise ValueError("batch_size must be an integer")
    if not 1 <= data["batch_size"] <= 1000:
        raise ValueError("batch_size must be between 1 and 1000")
    return data

if __name__ == "__main__":
    print(read_settings('{"enabled": true, "batch_size": 100}'))

```

示例特意使用 type(value) is int，而不是把所有可转换为数字的值都接受进来。这样不会把 true 当成批次数量，也不会将字符串 "100" 自动转换。是否允许转换是产品规则，应明确写出来，而不是由程序碰巧支持的转换方式决定。

重复字段在解析阶段拒绝，可以避免文件前后两处配置相互覆盖造成歧义。错误信息只报告字段名或约束，不应把包含令牌、路径凭据或其他敏感数据的整份配置直接写进共享日志。

## 用正反样本验证边界

正常样本是 {"enabled": true, "batch_size": 100}。本例另行检查了根节点为数组、重复字段、字符串开关、布尔批次、零批次、超过上限、非有限常量和未知字段八种输入，均会被拒绝。接入实际项目时，还应加入缺少字段、文件不存在、权限不足和编码错误等文件层面的样本。

仅有字段检查并不解决所有风险。对于外部提供的配置，应在读取或接收阶段限制文件体积，并根据场景控制嵌套深度和处理时间。也不要把配置中的字符串直接拼接为 shell 命令。本例没有动态执行功能，配置只影响明确列出的两个参数。

## 让失败发生在任务开始之前

如果一次批处理已经改动了部分文件才发现参数错误，恢复工作会比修正配置复杂得多。因此，可以先加载所有参数，完成输入检查，打印不含敏感内容的执行概要，再启动业务操作。配置错误应使这一轮任务停止，并保留原始文件供操作者修正；不要在报错后擅自用默认值继续运行。

参考： [Python 官方 json 文档](https://docs.python.org/3/library/json.html) 。本文示例代码为独立编写，并已使用上述正反样本验证。

说明：本文由 AI 辅助撰写，示意图为自行绘制，参数及场景为教学示例。

以一个批处理配置为例，检查重复字段、类型和范围，让参数错误在业务操作开始之前暴露，并用正反样本验证输入边界。

Python 读取 JSON 配置：把字段校验放在任务启动之前

编程语言

后端

开发工具

配置解析需经结构、类型、范围三层校验，杜绝重复键与未知字段，确保enabled为布尔、batchsize在1至1000间，失败即终止任务，避免运行期歧义。

敏感数据

Python

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Python 读取 JSON 配置：把字段校验放在任务启动之前-腾讯云开发者社区-腾讯云

Python 读取 JSON 配置：把字段校验放在任务启动之前

Python 读取 JSON 配置：把字段校验放在任务启动之前

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐