Flutter ListView无法显示PHP+MySQL返回数据问题求助

1. 字段映射是否完全匹配 #

• 核对PHP返回的JSON键名和Flutter代码里读取的字段名，大小写、下划线/驼峰必须完全一致。比如PHP返回goods_title，Flutter里写成goodsTitle又没做字段转换，肯定拿不到值。
• 日期字段先确认JSON里有没有这个键（比如create_date），再检查Flutter代码里有没有读取这个字段，别漏写了。

2. ListView数据绑定是否正确 #

• 确保itemCount是数据源的真实长度，比如itemCount: dataList.length，要是写死成0或者错用了其他变量，列表项根本不会渲染。
• 检查itemBuilder里的取值逻辑：如果用的是Map存数据，就得写item['title']；如果是自定义模型类，要确认模型的构造函数是否正确解析了JSON字段，比如：

class Goods {
  final String title;
  final String imageUrl;
  final String date;

  Goods({required this.title, required this.imageUrl, required this.date});

  factory Goods.fromJson(Map<String, dynamic> json) {
    return Goods(
      title: json['goods_title'], // 这里必须和JSON键名一致
      imageUrl: json['goods_image'],
      date: json['create_date'],
    );
  }
}

3. 图片加载的坑 #

• 先看PHP返回的图片路径：如果是相对路径（比如/uploads/1.jpg），Flutter里必须拼接完整域名（比如http://your-server.com/uploads/1.jpg），不然加载失败。
• 把图片URL复制到浏览器打开，确认图片能正常访问，排除图片不存在、权限限制的问题。
• 可以给Image.network()加个错误占位图，快速排查加载失败：

Image.network(
  item['goods_image'],
  errorBuilder: (ctx, err, stack) => Icon(Icons.broken_image),
)

4. 异步数据加载时机不对 #

• 别在初始化直接调用接口后就立刻渲染ListView，要等数据返回后再更新状态。推荐用FutureBuilder包裹ListView，或者在接口回调里调用setState更新数据源：

// 用FutureBuilder的示例
FutureBuilder<List<Goods>>(
  future: fetchGoodsList(), // 你的接口请求方法
  builder: (ctx, snapshot) {
    if (snapshot.connectionState == ConnectionState.done) {
      if (snapshot.hasData) {
        return ListView.builder(
          itemCount: snapshot.data!.length,
          itemBuilder: (ctx, idx) {
            var goods = snapshot.data![idx];
            return ListTile(
              leading: Image.network(goods.imageUrl),
              title: Text(goods.title),
              subtitle: Text(goods.date),
            );
          },
        );
      } else {
        return Text('暂无数据');
      }
    }
    return CircularProgressIndicator(); // 加载中状态
  },
)

5. 数据类型解析错误 #

• 日期字段一般是字符串，直接用Text()包裹就行，别随便转DateTime，万一格式不对会抛出异常导致字段不显示。先直接打印item['create_date']确认值是否正确。
• 其他字段同理，比如数字类型别用Text(item['price'].toString())以外的写法，避免类型转换报错。

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