json_decode()返回null主因是json格式错误、文件含bom头、编码非utf-8无bom、路径错误或未加true参数；应先file_get_contents()读取，再用json_last_error()定位问题，配置文件推荐json_decode(..., true) ?: []兜底。
PHP读JSON文件时json_decode()返回null怎么办
不是JSON格式错误就是编码/路径问题。最常见的是文件含BOM头、中文乱码或JSON语法不合法（比如末尾多逗号）。用file_get_contents()先读出来，再用json_last_error()和json_last_error_msg()定位真实原因。
- 检查文件是否UTF-8无BOM：用编辑器另存为“UTF-8（无BOM）”，别信默认编码
- 确认路径正确：
file_exists($path)必须为true，相对路径容易错在工作目录不是你想象的那个 -
json_decode(file_get_contents($path), true)第二个参数true必须加，否则返回对象而非数组 - 如果JSON里有数字字符串（如
"123"），json_decode()默认会转成int，想保留字符串得加选项JSON_BIGINT_AS_STRING
PHP解析JSON配置文件的典型写法
配置文件一般小而固定，直接读取+解码即可，不用流式处理。但要注意权限和缓存——Web服务器要能读文件，且别在循环里反复读。
- 推荐写法：
$config = json_decode(file_get_contents('/path/to/config.json'), true) ?: []; - 加个空数组兜底，避免后续代码因
null报Warning: Trying to access array offset on value of type null - 若配置文件可能被外部修改，上线前建议用
opcache_reset()或禁用OPcache对JSON文件的缓存（OPcache默认会缓存file_get_contents结果） - 别用
include或require加载.json文件——PHP不认识JSON语法，会直接Parse error
JSON配置 vs PHP原生数组配置的取舍
JSON适合纯数据型配置（如API地址、开关项），PHP数组适合需要逻辑判断或动态生成的配置（比如根据环境拼接DB主机名）。
- JSON优点：跨语言、结构清晰、不易执行意外代码；缺点：不支持注释、不能写表达式、无法包含PHP常量（如
__DIR__） - PHP配置文件（.php后缀）可return数组，能用
defined('ENV')做环境分支，但必须确保文件不在Web根目录下可直接访问，否则泄露敏感配置 - 混合方案常见：JSON存通用字段，PHP文件做环境适配层，
require_once后再array_merge覆盖
大JSON文件读取卡顿或内存溢出
超过几MB的JSON文件，file_get_contents()会一次性把全部内容载入内存，容易OOM。这时候得换思路。
立即学习“PHP免费学习笔记（深入）”；
- 优先考虑是否真需要全量加载：能不能只读某个key？用
json_decode()配合substr或正则提取片段是危险操作，别试 - 真正的大文件（>10MB）改用流式解析库，比如
ext-json不支持，得上jsonstream或json-machine这类迭代器方案 - 更现实的解法：把大配置拆成多个小JSON，按需加载；或者导出为PHP数组并启用OPcache，比解析JSON快一个数量级
- 用
memory_get_usage()测一下加载前后内存差，确认是不是JSON本身导致的——有时候是JSON里嵌了base64图片才暴涨
