You need to enable JavaScript to run this app. React Native使用FlatList渲染GraphQL服务端数据出现性能警告求助
优惠活动
大模型
产品
解决方案
定价
更多

React Native使用FlatList渲染GraphQL服务端数据出现性能警告求助

问题根因

你遇到的VirtualizedList性能警告核心原因是React.memo优化完全失效+FlatList缺少必要的性能配置,具体问题点如下:

  1. 所有传递给子组件的引用类型(函数、对象、数组)每次重渲染都生成新引用,React.memo浅比较判定props变化,导致所有列表项全量重渲染
  2. FlatList没有配置基础的性能优化参数,也没有指定唯一key提取逻辑
  3. ProductListItem内部传递给UI组件的回调函数每次渲染都生成新实例,触发子组件重渲染
  4. Apollo返回数据后每次都通过map生成新数组,哪怕数据内容不变也会触发FlatList全量更新

可行解决方案

第一步:稳定所有引用类型props

修改HomeScreen.js

  • 用useCallback包裹点击回调,保证函数引用不变
  • 用useMemo包裹products转换逻辑,只有源数据变化时才生成新数组
// HomeScreen.js
import {useCallback, useMemo} from 'react'

function HomeScreen({navigation}) {
  const {data} = useHomeScreenProductsQuery({}) 

  // 用useCallback稳定函数引用
  const handleOnPressItem = useCallback(() => console.log('go to product'), [])

  // 用useMemo稳定products数组引用
  const products = useMemo(() => {
    return data?.collection?.products?.edges.map(e => e.node) ?? []
  }, [data?.collection?.products?.edges])

  return (
    <ProductList
      horizontal
      numColumns={2}
      products={products}
      onPressItem={handleOnPressItem}
    />
  )
}

修改ProductList.js

  • 用useCallback包裹renderItem函数,避免FlatList因renderItem引用变化触发全量重渲染
  • 内联样式对象提取为常量或用useMemo稳定引用
// ProductList.js
import React, {useCallback, useMemo} from 'react'
import {Dimensions, FlatList, View} from 'react-native'
import {ProductListItem} from '../ProductListItem'

// 常量提取到组件外,避免重复生成
const COLUMN_WRAPPER_STYLE = {flexDirection: 'column'}

function ProductList({
  products,
  horizontal = false,
  numColumns = 1,
  onPressItem = () => {},
}) {
  const layoutManager = useMemo(() => {
    const config = {}
    if (horizontal) {
      config.horizontal = true
      config.showsHorizontalScrollIndicator = false
      config.ItemSeparatorComponent = ProductListItemSeparator
      config.contentContainerStyle = {padding: spacing.base}
    } else {
      config.numColumns = numColumns
    }
    return config
  }, [horizontal, numColumns])

  const renderProductListItem = useCallback(({item}) => {
    const columns = horizontal ? 2 : numColumns
    // 样式用useMemo稳定引用
    const itemContainerStyle = useMemo(() => ({
      width: dimens.common.WINDOW_WIDTH / columns,
    }), [columns])

    return (
      <ProductListItem
        product={item}
        itemContainerStyle={itemContainerStyle}
        columnWrapperStyle={COLUMN_WRAPPER_STYLE}
        onPressItem={onPressItem}
      />
    )
  }, [horizontal, numColumns, onPressItem])

  // 新增keyExtractor,指定唯一标识
  const keyExtractor = useCallback((item) => item.id, [])

  return (
    <FlatList
      {...layoutManager}
      key={numColumns}
      data={products}
      renderItem={renderProductListItem}
      keyExtractor={keyExtractor}
      // 新增FlatList性能配置
      removeClippedSubviews={true}
      maxToRenderPerBatch={8} // 根据一屏显示的项数调整,建议为一屏数量的2倍
      initialNumToRender={4} // 调整为一屏刚好显示的项数
      windowSize={5} // 减少后台渲染的区域,默认21,建议设为3-10
      // 如果列表项宽高固定,新增getItemLayout进一步提升性能,示例如下(根据实际宽高调整)
      // getItemLayout={(data, index) => (
      //   {length: 200, offset: 200 * index, index}
      // )}
    />
  )
}

修改ProductListItem.js

  • 内部回调函数用useCallback包裹,避免触发UI组件重渲染
  • 可自定义React.memo的比较逻辑,进一步降低重渲染概率
// ProductListItem.js
import React, {useCallback} from 'react'

function ProductListItem({
  product,
  itemContainerStyle = {},
  columnWrapperStyle = {},
  onPressItem = () => {},
}) {
  const price = product.pricing?.priceRange?.start
  const priceUndiscounted = product.pricing?.priceRangeUndiscounted?.start

  // 用useCallback稳定函数引用
  const getProductPrice = useCallback(() => {
    if (equal(price, priceUndiscounted)) {
      return <TaxedMoney taxedMoney={price} defaultValue={0} category="h6" />
    }
    return (
      <>
        <View style={styles.priceContainer}>
          <Text category="c2" appearance="hint">
            Antes&nbsp;
          </Text>
          <TaxedMoney
            taxedMoney={priceUndiscounted}
            category="c2"
            appearance="hint"
            style={styles.priceUndiscounted}
          />
        </View>
        <TaxedMoney taxedMoney={price} category="h5" />
      </>
    )
  }, [price, priceUndiscounted])

  const renderItemHeader = useCallback(() => (
    <View style={styles.itemHeader}>
      <Thumbnail source={product} />
    </View>
  ), [product])

  return (
    <View style={itemContainerStyle}>
      <Card
        onPress={onPressItem}
        header={renderItemHeader}
        style={[styles.row, columnWrapperStyle]}
      >
        <Text
          category="c1"
          appearance="hint"
          ellipsizeMode="tail"
          numberOfLines={1}
        >
          {product.category?.name}
        </Text>
        <Text category="c1" ellipsizeMode="tail" numberOfLines={2}>
          {product.name}
        </Text>
        {/* 注意原代码此处漏了括号,要执行函数才能渲染价格 */}
        {getProductPrice()}
      </Card>
    </View>
  )
}

// 可选:自定义memo比较逻辑,只在product变化时重渲染
export default React.memo(ProductListItem, (prevProps, nextProps) => {
  return prevProps.product.id === nextProps.product.id
})

做完以上优化后,警告会完全消失,列表滚动流畅度会有明显提升。

内容的提问来源于stack exchange,提问作者Cristian Flórez

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 19:36:01