Flutter调用Laravel API时URL类型字段键丢失问题求助

问题现象 #

Laravel后端API返回的businessLinks数组中，包含带UUID的长URL字段linkUrl，在网页、Postman中能正常获取完整键值对，但Flutter端通过Dio/Retrofit请求时，linkUrl键丢失，仅保留URL值；短URL对应的字段键能正常保留，更新相关依赖后问题依旧。

可能原因及解决办法 #

1. Json序列化/反序列化配置问题

检查Flutter端json_serializable注解是否正确，确保模型类中linkUrl字段的注解无错误：

@JsonSerializable()
class BusinessLink {
  final String linkTitle;
  final String linkUrl;

  BusinessLink({required this.linkTitle, required this.linkUrl});

  factory BusinessLink.fromJson(Map<String, dynamic> json) => _$BusinessLinkFromJson(json);
  Map<String, dynamic> toJson() => _$BusinessLinkToJson(this);
}

• 执行flutter pub run build_runner build重新生成序列化代码，避免注解遗漏或生成文件过期。

2. Dio的响应拦截器/转换器异常

排查Dio是否自定义了响应转换器或拦截器，这类逻辑可能在处理长URL时破坏JSON结构：

Dio dio = Dio();
// 临时禁用所有自定义响应拦截器和转换器，测试是否能正常解析字段
// dio.interceptors.clear();
// dio.transformer = DefaultTransformer();

• 逐步启用拦截器，定位是否有修改响应JSON的代码逻辑。

3. Laravel后端响应编码/字段拼写问题

检查Laravel返回响应的代码，确保字段名正确且返回标准JSON：

return response()->json([
    'businessLinks' => $businessLinks->map(function ($item) {
        return [
            'linkTitle' => $item->link_title,
            'linkUrl' => $item->link_url, // 确认字段名拼写与前端模型一致
        ];
    })
]);

• 确认config/app.php中charset为UTF-8，避免编码异常导致JSON解析错误。

4. Retrofit接口定义不匹配

检查Retrofit接口的返回类型，确保与模型类泛型匹配：

@GET('business/links')
Future<ApiResponse<List<BusinessLink>>> getBusinessLinks();

• 避免因返回类型不匹配，导致序列化时丢失字段。

5. 长URL特殊字符解析问题

部分JSON解析库对含特殊字符的长URL处理异常，可尝试在Laravel端对URL编码，Flutter端解码：

// Laravel端编码URL
'linkUrl' => urlencode($item->link_url),

// Flutter端解码URL
final String decodedUrl = Uri.decodeFull(linkUrl);

内容的提问来源于stack exchange，提问作者Atlas-Pio