如何解决 PHP 与 Java 之间的 JSON 数据转换格式不一致_规范字段命名

夜萱姑娘_2202

夜萱姑娘_2202

2026-04-25

203人浏览

原创

java后端需配置jackson支持下划线转驼峰(如spring.jackson.property-naming-strategy=snake_case),php侧应启用json_unescaped_unicode并统一数据类型,避免空值歧义。

如何解决 php 与 java 之间的 json 数据转换格式不一致_规范字段命名

PHP 传给 Java 的 JSON 字段名大小写不一致

Java 后端(尤其 Spring Boot + Jackson)默认按驼峰命名(userName)反序列化,而 PHP 数组键名常为下划线风格(user_name),直接传过去会导致字段为空或 400 错误。

根本不是“Java 不认下划线”,而是 Jackson 默认没开启下划线转驼峰支持。PHP 侧无需改键名,Java 侧加配置即可统一:

  • Spring Boot 全局启用:spring.jackson.property-naming-strategy=SNAKE_CASE(推荐)
  • 单个 DTO 类加注解:@JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
  • 若用老版本 Jackson(@JsonNaming(PropertyNamingStrategy.SnakeCaseStrategy.class)

别在 PHP 里用 ucwords(str_replace('_', ' ', $key)) 拼驼峰——易出错、难维护、还可能破坏已有前端契约。

Java 传给 PHP 的 JSON 数字字段被当成字符串

典型现象:"id": "12345678901234567890"(带引号)到 PHP 后,json_decode() 解出来是 string,但业务逻辑误当 int 用,后续计算或比较出错。

这不是 PHP 解析错了,而是 Java 端序列化时把大整数当字符串输出了(出于安全考虑)。PHP 侧不能依赖自动类型转换,必须显式处理:

Feishu calendar sync, local ics to json data for AI agent
Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式,用于飞书日历导入导出及数据集成。

下载
  • 对已知是 ID/时间戳等大整数字段,接收后立刻用 filter_var($val, FILTER_VALIDATE_INT) 或 is_numeric($val) && (int)$val == $val 判断是否可安全转 int
  • 若可能超 PHP_INT_MAX(如 64 位主键),一律保留为 string,后续传给 MySQL 或 Redis 时也用 string 类型操作
  • 避免用 (int)$val 强转——32 位环境或超范围值会静默变负数或 0

PHP 输出 JSON 时中文字段名被转成 \uXXXX

比如 PHP 数组 ['用户名称' => '张三'] 经 json_encode() 后变成 {"\u7528\u6237\u540d\u79f0":"张三"},Java 端解析时字段名对不上。

问题出在没启用 JSON_UNESCAPED_UNICODE 标志,且字段名本身是中文(非 ASCII 键名):

  • 必须加标志:json_encode($data, JSON_UNESCAPED_UNICODE)
  • 确保整个 PHP 脚本文件保存为 UTF-8 无 BOM 编码
  • 数据库查出来的字段别名如果含中文(如 SELECT name AS '用户名' FROM user),PHP 获取后仍是字符串键,同样需该标志才不转义

注意:这个标志只影响键名和字符串值里的中文,不影响数字或布尔值的格式。

双方共用字段命名规范但 PHP 生成 JSON 仍不一致

即使约定都用 snake_case,PHP 输出的 JSON 还是和 Java 不一致?大概率是 PHP 数据源本身类型混乱:

  • 从数据库查出的字段,MySQL 的 ENUM 或 SET 类型在 PHP 中可能返回 int 或 string,取决于驱动和配置;用 mysqli_fetch_assoc() 通常得 string,PDO::FETCH_ASSOC 可能因 PDO::ATTR_STRINGIFY_FETCHES 设置不同而异
  • 从缓存(Redis)取的数据是 string,json_decode($redisVal, true) 后再拼数组,容易混入 string 类型的数字字段
  • 关键动作:输出前用 array_walk_recursive() 扫一遍,对已知应为数字的字段(如 price, count)做 is_numeric($v) ? (float)$v : $v 处理,避免 "price": "99.9" 这种歧义

最易被忽略的是:PHP 对空字符串 ''、null、0 的 JSON 序列化结果完全一样(都是 null 或 0),但 Java 端反序列化时行为可能不同——务必在协议层明确空值语义,不要依赖隐式转换。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php java js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10177

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7302

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6432

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1104

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

908

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1336

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2689

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19991

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1195

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习