You need to enable JavaScript to run this app. React项目无刷新更新新上传头像的实现方案(未使用Redux)
优惠活动
大模型
产品
解决方案
定价
更多

React项目无刷新更新新上传头像的实现方案(未使用Redux)

头像上传无刷新更新实现方案

问题根源

  • 上传成功后返回的新头像信息仅存储在useStorage自定义钩子的内部状态,没有对外传递
  • Avatar组件的头像请求仅在auth.token变化时触发,上传流程没有触发其重新拉取数据的通道
  • 上传链路和头像展示链路的状态完全独立,无联动机制

全局状态选型说明

不需要引入Redux,两种场景分别对应两种实现方案,均基于现有架构即可完成:

  • 若头像仅在当前上传页面使用,使用状态提升即可,无需新增全局状态
  • 若头像会在多个页面/组件复用,直接复用已有的AuthContext扩展,不需要新增Context实例

方案一:状态提升(仅当前页面使用头像)

适用于上传组件和头像组件同属一个父页面的场景,实现轻量无全局污染。

修改步骤

  • 找到UploadForm和Avatar的共同父组件,新增newAvatar状态用于存储上传成功的新头像文件名
  • 改造ProgressBar组件,新增onUploadSuccess回调参数,上传成功后把新头像信息回传给父组件
  • 改造UploadForm组件,把父组件传入的onUploadSuccess回调透传给ProgressBar
  • 改造Avatar组件,新增overrideAvatar参数,优先展示外部传入的新头像,无外部传入时再用自身请求的旧头像

对应修改代码

改造后的ProgressBar.js

import React, { useEffect } from "react";
import useStorage from "../../hooks/use-storage";
import { motion } from "framer-motion";
import "./ProgressBar.css";

const ProgressBar = ({ file, setFile, onUploadSuccess }) => {
  const { url, progress } = useStorage(file);

  useEffect(() => {
    if (url) {
      onUploadSuccess(url.filename);
      setFile(null);
    }
  }, [url, setFile, onUploadSuccess]);

  return (
    <motion.div
      className="upload-progress"
      initial={{ width: 0 }}
      animate={{ width: progress + "%" }}
    ></motion.div>
  );
};

export default ProgressBar;

改造后的UploadForm.js

import React, { useState } from "react";
import ProgressBar from "../../../shared/components/progressBar/ProgressBar";

const UploadForm = ({ onUploadSuccess }) => {
  const [file, setFile] = useState(null);
  const [error, setError] = useState(null);

  const types = ["image/png", "image/jpg", "image/jpeg"];

  const changeHandler = (e) => {
    let selected = e.target.files[0];

    if (selected && types.includes(selected.type)) {
      setFile(selected);
      setError("");
    } else {
      setFile(null);
      // 修正原代码漏写的右括号
      setError("Please select an image file(png or jpg)");
    }
  };
  return (
    <form>
      <input type="file" onChange={changeHandler} name="image"></input>
      <div className="output">
        {error && <div className="error">{error}</div>}
        {file && <div>{file.name}</div>}
        {file && <ProgressBar file={file} setFile={setFile} onUploadSuccess={onUploadSuccess} />}
      </div>
    </form>
  );
};

export default UploadForm;

改造后的Avatar.js(状态提升版本)

import React, { useContext, useEffect, useState } from "react";
import Axios from "axios";
import { AuthContext } from "../../../shared/context/auth-context";

const Avatar = ({ overrideAvatar }) => {
  const auth = useContext(AuthContext);
  const [avatar, setAvatar] = useState(null);

  useEffect(() => {
    const getAvatarImage = async () => {
      const response = await Axios.get(
        "http://localhost:8000/api/v1/users/get-avatar",
        { headers: { Authorization: "Bearer " + auth.token } }
      );
      setAvatar(response.data.avatar);
    };
    if (auth.token) getAvatarImage();
  }, [auth.token]);

  // 外部传入的新头像优先级更高
  const displayAvatar = overrideAvatar || avatar;

  return (
    <div>
      {displayAvatar && (
        <img
          src={`http://localhost:8000/uploads/images/${displayAvatar}`}
          width="200"
          alt="avatar image"
        />
      )}
    </div>
  );
};

export default Avatar;

共同父组件使用示例

import React, { useState } from "react";
import UploadForm from "./components/UploadForm";
import Avatar from "./components/Avatar";

const ProfilePage = () => {
  const [newAvatar, setNewAvatar] = useState(null);

  return (
    <div>
      <Avatar overrideAvatar={newAvatar} />
      <UploadForm onUploadSuccess={(filename) => setNewAvatar(filename)} />
    </div>
  );
};

方案二:扩展现有AuthContext(多页面复用头像)

适用于头像会在多个页面/组件使用的场景,复用现有全局上下文,不需要新增状态管理依赖。

修改步骤

  • 给AuthContext新增avatar状态字段和updateAvatar更新方法
  • 改造useStorage钩子,上传成功后直接调用updateAvatar更新全局头像状态
  • 改造Avatar组件,直接从AuthContext读取头像状态,无需单独请求(可保留原请求作为兜底)

对应修改代码

改造后的auth-context.js

import { createContext } from "react";

export const AuthContext = createContext({
  isLoggedIn: false,
  userId: null,
  token: null,
  email: null,
  firstName: null,
  avatar: null, // 新增头像字段
  login: () => {},
  logout: () => {},
  updateAvatar: () => {} // 新增更新头像方法
});

注:需要在AuthContext的Provider实现里补充updateAvatar的具体逻辑,用来修改全局的avatar状态

改造后的use-storage.js

import React, { useState, useEffect, useContext } from "react";
import Axios from "axios";
import { AuthContext } from "../context/auth-context";

const useStorage = (file) => {
  const auth = useContext(AuthContext);
  const [progress, setProgress] = useState(0);
  const [error, setError] = useState(null);
  const [url, setUrl] = useState(null);

  useEffect(() => {
    // 无文件时不触发上传
    if (!file) return;
    const formData = new FormData();
    formData.append("image", file);

    // 把异步错误处理移到async函数内部,避免被外层同步try/catch吞掉
    const sendImage = async () => {
      try {
        const response = await Axios.post(
          "http://localhost:8000/api/v1/users/update-avatar",
          formData,
          {
            headers: {
              "Content-type": "multipart/form-data",
              Authorization: "Bearer " + auth.token,
            },
            onUploadProgress: (progressEvent) => {
              setProgress(
                parseInt(
                  Math.round((progressEvent.loaded * 100) / progressEvent.total)
                )
              );
            },
          }
        );
        const { filename } = response.data.file;
        // 上传成功后更新全局头像状态
        auth.updateAvatar(filename);
        setUrl(filename);
      } catch (err) {
        setError(err);
        console.log(err.response);
      }
    };

    sendImage();
  }, [file, auth]);

  return { progress, url, error };
};

export default useStorage;

改造后的Avatar.js(全局版本)

import React, { useContext } from "react";
import { AuthContext } from "../../../shared/context/auth-context";

const Avatar = () => {
  const auth = useContext(AuthContext);
  // 直接读取全局的头像状态
  const avatar = auth.avatar;

  return (
    <div>
      {avatar && (
        <img
          src={`http://localhost:8000/uploads/images/${avatar}`}
          width="200"
          alt="avatar image"
        />
      )}
    </div>
  );
};

export default Avatar;

现有代码遗留问题修正

  • 原UploadForm的错误提示漏写了右括号,已在上述修改中修正
  • 原useStorage的useEffect依赖数组缺少auth对象,会导致闭包读取到旧的token,已补充到依赖数组
  • 原useStorage的try/catch包裹的是同步调用,无法捕获async函数的异步错误,已调整错误处理位置

内容的提问来源于stack exchange,提问作者Waterfall

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.09 01:06:10