上传头像 (angular 16)

文件上传笔记:以「上传头像」为例

前端:Angular 16(standalone) · 后端:Go + Gin + SQLite(与 cart-api 同一套结构) 覆盖:选择文件 → 前端校验 → 预览 → 上传 → 后端校验与保存 → 入库 → 展示 → 替换/删除。 本篇独立成篇 :不依赖 ANGULAR-NOTES.md,每个小节都带 import / HTML / TS(或 Go)。 文中的 Go 代码已在 Gin 1.10 + SQLite 下用 curl 实测通过,前端代码已通过 Angular 严格模板编译检查。

目录

  1. 整体流程
  2. 数据库表的定义
  3. [后端 Gin:接收并保存文件](#后端 Gin:接收并保存文件 "#3-%E5%90%8E%E7%AB%AF-gin%E6%8E%A5%E6%94%B6%E5%B9%B6%E4%BF%9D%E5%AD%98%E6%96%87%E4%BB%B6")
  4. [前端:Service(发送 FormData)](#前端:Service(发送 FormData) "#4-%E5%89%8D%E7%AB%AFservicedformdata")
  5. 前端:组件(选择、校验、预览、上传、展示)
  6. 头像怎么展示(缓存、兜底、样式、私有图片)
  7. 上传进度条
  8. 多个页面共享头像(导航栏同步刷新)
  9. [文件 + 普通字段一起提交(multipart 表单)](#文件 + 普通字段一起提交(multipart 表单) "#9-%E6%96%87%E4%BB%B6--%E6%99%AE%E9%80%9A%E5%AD%97%E6%AE%B5%E4%B8%80%E8%B5%B7%E6%8F%90%E4%BA%A4")
  10. [用 curl 测试后端](#用 curl 测试后端 "#10-%E7%94%A8-curl-%E6%B5%8B%E8%AF%95%E5%90%8E%E7%AB%AF")
  11. 常见坑速查

1. 整体流程

bash 复制代码
┌─ 浏览器 ──────────────────────────────┐        ┌─ Gin 后端 ─────────────────────────────┐
│ <input type="file"> 选图               │        │                                        │
│  → 前端校验(类型/大小)                │        │                                        │
│  → URL.createObjectURL 本地预览        │        │                                        │
│  → FormData.append('avatar', file)     │        │                                        │
│  → POST /api/me/avatar (multipart) ────┼──────► │ 校验登录(token)                        │
│                                        │        │ c.FormFile("avatar") 取文件            │
│                                        │        │ 嗅探文件头,校验真实类型/大小           │
│                                        │        │ 随机文件名 → 存到磁盘 uploads/avatars/ │
│                                        │        │ UPDATE users SET avatar=文件名         │
│  ← {"avatarUrl":"/uploads/avatars/x.png"} ◄─────┤ 删除旧头像文件                         │
│ <img [src]="FILE_BASE + avatarUrl">    │        │                                        │
│  → GET /uploads/avatars/x.png ─────────┼──────► │ r.Static("/uploads", "./uploads")      │
└────────────────────────────────────────┘        └────────────────────────────────────────┘

核心设计决定

问题 做法 原因
文件存哪 磁盘 目录,数据库只存文件名 数据库存二进制(BLOB)会让库变大、备份慢;文件由静态服务直接发送更快
文件名 服务端生成随机串 + 扩展名 防重名覆盖、防路径穿越(../../x)、换头像后 URL 变化可绕开浏览器缓存
类型校验 读文件头嗅探真实类型 文件名、前端传的 Content-Type 都能伪造
请求格式 multipart/form-data 文件上传的标准格式,不是 JSON

2. 数据库表的定义

本项目 users 表加一列 avatar,只存文件名(不含目录),空串表示没设置头像。

新建数据库(schema.sql)

sql 复制代码
CREATE TABLE IF NOT EXISTS users (
    id            INTEGER PRIMARY KEY AUTOINCREMENT,
    email         TEXT NOT NULL UNIQUE,
    password_hash TEXT NOT NULL,
    avatar        TEXT NOT NULL DEFAULT '',   -- 头像文件名,如 'b7d190f0...png';空串=没设置
    created_at    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);

已有数据库(cart.db 已经建过表)

CREATE TABLE IF NOT EXISTS 对已存在的表不会加新列 ,要手动迁移一次:

bash 复制代码
sqlite3 cart.db "ALTER TABLE users ADD COLUMN avatar TEXT NOT NULL DEFAULT ''"

重复执行会报 duplicate column name: avatar,说明已经加过了,无需处理。 没有重要数据时,也可以直接删掉 cart.db 让程序重新建表。

为什么存文件名而不是完整 URL

  • 以后换域名、换 CDN、换目录,只改代码里的拼接规则,不用改数据。
  • 返回给前端时再拼:/uploads/avatars/ + 文件名。

可选:通用文件表(多文件、多种附件时)

头像一人一张,一列就够。如果是商品多图、订单附件这类"一对多",单独建表:

sql 复制代码
CREATE TABLE IF NOT EXISTS files (
    id          INTEGER PRIMARY KEY AUTOINCREMENT,
    user_id     INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
    kind        TEXT NOT NULL,              -- 用途:'avatar' / 'product_image' ...
    stored_name TEXT NOT NULL UNIQUE,       -- 磁盘上的随机文件名
    orig_name   TEXT NOT NULL DEFAULT '',   -- 用户原始文件名(仅展示用,不用来存盘)
    mime        TEXT NOT NULL,              -- 嗅探出的真实类型
    size        INTEGER NOT NULL,           -- 字节数
    created_at  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);
CREATE INDEX IF NOT EXISTS idx_files_user ON files(user_id, kind);

3. 后端 Gin:接收并保存文件

import(新文件 avatar.go)

go 复制代码
package main

import (
	"crypto/rand"
	"encoding/hex"
	"net/http"
	"os"
	"path/filepath"

	"github.com/gin-gonic/gin"
)

常量与工具函数

go 复制代码
const (
	uploadDir     = "uploads/avatars"   // 磁盘目录(相对程序运行目录)
	avatarURLBase = "/uploads/avatars/" // 对外访问路径(与 r.Static 对应)
	maxAvatarSize = 2 << 20             // 2MB
)

// 允许的类型:文件头嗅探出的 MIME -> 保存用的扩展名
// 故意不允许 svg:svg 里可以嵌脚本,有 XSS 风险
var allowedImageExt = map[string]string{
	"image/jpeg": ".jpg",
	"image/png":  ".png",
	"image/webp": ".webp",
	"image/gif":  ".gif",
}

// 数据库只存文件名,返回给前端时拼成 URL 路径;没有头像返回空串
func avatarURL(file string) string {
	if file == "" {
		return ""
	}
	return avatarURLBase + file
}

上传处理函数

go 复制代码
// POST /api/me/avatar:multipart/form-data,文件字段名必须是 avatar
func (s *Server) uploadAvatar(c *gin.Context) {
	// 1. 限制请求体总大小,防止超大文件撑爆内存/磁盘(多留 1MB 给 multipart 自身开销)
	c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, maxAvatarSize+(1<<20))

	// 2. 取文件:字段名要和前端 formData.append('avatar', file) 一致
	fh, err := c.FormFile("avatar")
	if err != nil {
		invalid(c, map[string]string{"avatar": "avatar file is required (max 2MB)"})
		return
	}
	if fh.Size > maxAvatarSize {
		invalid(c, map[string]string{"avatar": "file too large (max 2MB)"})
		return
	}

	// 3. 校验真实类型:不信文件名,也不信前端传的 Content-Type,读文件头 512 字节自己判断
	f, err := fh.Open()
	if err != nil {
		fail(c, 500, "internal error")
		return
	}
	defer f.Close()
	head := make([]byte, 512)
	n, _ := f.Read(head)
	ext, ok := allowedImageExt[http.DetectContentType(head[:n])]
	if !ok {
		invalid(c, map[string]string{"avatar": "only jpg, png, webp, gif are allowed"})
		return
	}

	// 4. 文件名用随机串:防重名、防路径穿越;绝不使用用户给的文件名
	b := make([]byte, 16)
	_, _ = rand.Read(b)
	name := hex.EncodeToString(b) + ext
	if err := c.SaveUploadedFile(fh, filepath.Join(uploadDir, name)); err != nil {
		fail(c, 500, "save file failed")
		return
	}

	// 5. 更新数据库;先记下旧文件名,更新成功后再删旧文件
	var old string
	_ = s.db.QueryRow(`SELECT avatar FROM users WHERE id=?`, uid(c)).Scan(&old)
	if _, err := s.db.Exec(`UPDATE users SET avatar=? WHERE id=?`, name, uid(c)); err != nil {
		_ = os.Remove(filepath.Join(uploadDir, name)) // 入库失败 → 把刚存的文件删掉,不留垃圾
		fail(c, 500, "internal error")
		return
	}
	if old != "" {
		_ = os.Remove(filepath.Join(uploadDir, filepath.Base(old)))
	}

	c.JSON(http.StatusOK, gin.H{"avatarUrl": avatarURL(name)})
}

// POST /api/me/avatar/delete:删除头像(清空字段 + 删文件)
func (s *Server) deleteAvatar(c *gin.Context) {
	var old string
	_ = s.db.QueryRow(`SELECT avatar FROM users WHERE id=?`, uid(c)).Scan(&old)
	if _, err := s.db.Exec(`UPDATE users SET avatar='' WHERE id=?`, uid(c)); err != nil {
		fail(c, 500, "internal error")
		return
	}
	if old != "" {
		_ = os.Remove(filepath.Join(uploadDir, filepath.Base(old)))
	}
	c.JSON(http.StatusOK, gin.H{"avatarUrl": ""})
}

fail(...)、invalid(...)、uid(c) 是本项目 handlers.go 里已有的工具函数 (统一错误格式、从 Context 取当前用户 id)。别的项目请自行替换成 c.JSON(...)。

修改 /me:把头像地址一起返回

go 复制代码
// GET /api/me:当前用户信息(含头像地址,没设置时 avatarUrl 为空串)
func (s *Server) me(c *gin.Context) {
	var email, avatar string
	_ = s.db.QueryRow(`SELECT email,avatar FROM users WHERE id=?`, uid(c)).Scan(&email, &avatar)
	c.JSON(200, gin.H{"id": uid(c), "email": email, "avatarUrl": avatarURL(avatar)})
}

修改 main.go:建目录、静态目录、注册路由

go 复制代码
// 1. 建表之后:确保上传目录存在
	seedProducts(db)
	if err := os.MkdirAll(uploadDir, 0o755); err != nil {
		log.Fatal(err)
	}

// 2. 创建 gin 引擎之后
	r := gin.Default()
	r.MaxMultipartMemory = 8 << 20     // multipart 内存缓冲上限(默认 32MB),超出部分写临时文件
	r.Static("/uploads", "./uploads")  // GET /uploads/avatars/xxx.png → 磁盘 ./uploads/avatars/xxx.png

// 3. 登录后才能访问的路由组里
		auth.GET("/me", s.me)
		auth.POST("/me/avatar", s.uploadAvatar)        // 上传头像
		auth.POST("/me/avatar/delete", s.deleteAvatar) // 删除头像
  • main.go 需要已 import "os"(本项目已有)。
  • r.Static 默认不开启目录列表 (访问 /uploads/avatars/ 返回 404),这是安全的。
  • 项目约定只用 GET/POST,所以删除也是 POST .../delete。标准 REST 应该用 DELETE /me/avatar。

.gitignore 加一行

复制代码
uploads/

关键 API 速查

API 作用
c.FormFile("avatar") 取一个上传文件,返回 *multipart.FileHeader(含 .Filename、.Size)
c.MultipartForm() 取整个 multipart,多文件时用 form.File["photos"] 得到切片
c.PostForm("nickname") 取同一个 multipart 里的普通文本字段
c.SaveUploadedFile(fh, dst) 把上传的文件保存到磁盘路径 dst(目录要先存在)
http.DetectContentType(bytes) 根据文件头(最多 512 字节)判断真实 MIME
http.MaxBytesReader 限制请求体最大字节数,超出读取时报错
r.MaxMultipartMemory multipart 解析时内存缓冲上限,超出部分写临时文件
r.Static(url, dir) 把目录作为静态文件服务

4. 前端:Service(发送 FormData)

import

ts 复制代码
// src/app/services/profile.service.ts
import { HttpClient } from '@angular/common/http';
import { Injectable } from '@angular/core';

TS

ts 复制代码
const API_URL = 'http://localhost:8081/api';
// 静态文件在 /uploads 下,不在 /api 下,所以单独一个基地址
export const FILE_BASE = 'http://localhost:8081';

export interface Me {
  id: number;
  email: string;
  avatarUrl: string; // 如 '/uploads/avatars/xxx.png';没设置头像时是 ''
}

@Injectable({ providedIn: 'root' })
export class ProfileService {
  constructor(private http: HttpClient) {}

  me() {
    return this.http.get<Me>(`${API_URL}/me`);
  }

  uploadAvatar(file: File) {
    const fd = new FormData();
    fd.append('avatar', file); // 字段名 'avatar' 必须和后端 c.FormFile("avatar") 一致
    // 直接把 FormData 作为请求体传入即可
    return this.http.post<{ avatarUrl: string }>(`${API_URL}/me/avatar`, fd);
  }

  deleteAvatar() {
    return this.http.post<{ avatarUrl: string }>(`${API_URL}/me/avatar/delete`, {});
  }
}

注意点

  • 不要手动设置 Content-Type 。浏览器发 FormData 时会自动生成 multipart/form-data; boundary=----xxx,手动写会丢掉 boundary,后端解析失败。
  • 如果项目有 authInterceptor 自动加 Authorization 头:它只加这一个头、不改 Content-Type,所以上传不受影响。
  • FormData 可以 append 多个字段,同名多次 append 对应后端的多文件。
  • 需要全局注册 provideHttpClient(...)(app.config.ts),否则注入 HttpClient 报错。

5. 前端:组件(选择、校验、预览、上传、展示)

import

ts 复制代码
// src/app/pages/avatar-upload.component.ts
import { HttpErrorResponse } from '@angular/common/http';
import { CommonModule } from '@angular/common';             // *ngIf
import { Component, OnDestroy, OnInit } from '@angular/core';
import { FILE_BASE, ProfileService } from '../services/profile.service';

HTML(内联在 template 中)

html 复制代码
<h2>我的头像</h2>

<!-- 有图显示图,没图显示占位 -->
<img *ngIf="displaySrc; else placeholder"
     class="avatar" [src]="displaySrc" alt="avatar" (error)="onImgError()" />
<ng-template #placeholder><div class="avatar placeholder">?</div></ng-template>

<!-- 原生文件选择框:隐藏起来,用按钮触发(原生控件很丑,无法自定义样式) -->
<!-- #fileInput 是模板引用变量,按钮里用 fileInput.click() 打开选择对话框 -->
<input #fileInput type="file" hidden
       accept="image/png,image/jpeg,image/webp,image/gif"
       (change)="onFileSelected($event)" />

<button type="button" (click)="fileInput.click()">选择图片</button>
<button type="button" (click)="upload()" [disabled]="!selectedFile || uploading">
  {{ uploading ? '上传中...' : '上传' }}
</button>
<button type="button" (click)="remove()" [disabled]="!avatarUrl || uploading">删除头像</button>

<p class="error" *ngIf="error">{{ error }}</p>

TS

ts 复制代码
@Component({
  selector: 'app-avatar-upload',
  standalone: true,
  imports: [CommonModule],
  template: `...上面的 HTML...`,
})
export class AvatarUploadComponent implements OnInit, OnDestroy {
  avatarUrl = '';                   // 服务器上的头像路径(如 '/uploads/avatars/x.png')
  selectedFile: File | null = null; // 已选中、还没上传的文件
  previewUrl = '';                  // 本地预览地址(blob:...)
  uploading = false;
  error = '';

  // 前端校验:只是体验优化,后端仍会再校验一次
  readonly maxSize = 2 * 1024 * 1024;
  readonly allowedTypes = ['image/png', 'image/jpeg', 'image/webp', 'image/gif'];

  constructor(private profile: ProfileService) {}

  // 展示地址:有本地预览优先显示预览,否则显示服务器上的头像
  get displaySrc(): string {
    if (this.previewUrl) return this.previewUrl;
    return this.avatarUrl ? FILE_BASE + this.avatarUrl : '';
  }

  ngOnInit() {
    // 进入页面时取当前头像
    this.profile.me().subscribe({
      next: (me) => (this.avatarUrl = me.avatarUrl),
      error: () => (this.error = '加载用户信息失败'),
    });
  }

  // 选择文件后触发
  onFileSelected(e: Event) {
    const input = e.target as HTMLInputElement;
    const file = input.files?.[0];     // input.files 是 FileList,可能为空(用户点了取消)
    input.value = '';                  // 清空,这样再次选同一个文件也能触发 change
    this.error = '';
    if (!file) return;

    if (!this.allowedTypes.includes(file.type)) {
      this.error = '只支持 png / jpg / webp / gif';
      return;
    }
    if (file.size > this.maxSize) {
      this.error = '图片不能超过 2MB';
      return;
    }

    this.clearPreview();                           // 释放上一个预览
    this.selectedFile = file;
    this.previewUrl = URL.createObjectURL(file);   // 生成本地预览地址,无需上传就能显示
  }

  upload() {
    if (!this.selectedFile) return;
    this.uploading = true;
    this.error = '';

    this.profile.uploadAvatar(this.selectedFile).subscribe({
      next: (res) => {
        this.avatarUrl = res.avatarUrl;  // 换成服务器返回的新地址
        this.selectedFile = null;
        this.clearPreview();             // 预览不再需要,<img> 自动改为显示 avatarUrl
        this.uploading = false;
      },
      error: (err: HttpErrorResponse) => {
        this.uploading = false;
        this.error = this.errorMessage(err);
      },
    });
  }

  remove() {
    this.profile.deleteAvatar().subscribe({
      next: () => (this.avatarUrl = ''),
      error: (err: HttpErrorResponse) => (this.error = this.errorMessage(err)),
    });
  }

  onImgError() {
    this.error = '图片加载失败';
  }

  // 取后端错误:422 → errors.avatar;其它 → message;连不上 → status 0
  private errorMessage(err: HttpErrorResponse): string {
    if (err.status === 0) return '无法连接服务器,请确认后端已启动';
    return err.error?.errors?.avatar ?? err.error?.message ?? '上传失败';
  }

  // blob URL 会一直占内存,不用了要手动释放
  private clearPreview() {
    if (this.previewUrl) URL.revokeObjectURL(this.previewUrl);
    this.previewUrl = '';
  }

  ngOnDestroy() {
    this.clearPreview();
  }
}

样式(可放在 styles 或全局 CSS)

css 复制代码
.avatar { width: 120px; height: 120px; border-radius: 50%; object-fit: cover; display: block; }
.placeholder { background: #ddd; color: #888; display: flex; align-items: center; justify-content: center; font-size: 48px; }

注册路由(可选)

ts 复制代码
// app.routes.ts
{ path: 'avatar', component: AvatarUploadComponent, canActivate: [authGuard] },

知识点拆解

点 说明
<input type="file"> 原生控件,选中的文件在 input.files(FileList),files[0] 是 File 对象
accept="image/png,..." 只是让选择对话框默认过滤,用户仍可选"所有文件",所以还要校验
file.type / file.size 浏览器根据扩展名给出的 MIME / 字节数,可伪造,仅用于前端体验提示
URL.createObjectURL(file) 生成 blob: 临时地址,可直接放进 <img [src]> 预览,不用上传
URL.revokeObjectURL(url) 释放该临时地址占用的内存
input.value = '' 不清空的话,再次选同一个文件不会触发 (change)
[src] 绑定 blob: 地址 Angular 16 的 URL 消毒允许 blob:,可直接绑定
隐藏 input + 按钮 原生文件框样式无法自定义,常用 hidden + #ref.click()

6. 头像怎么展示

6.1 基本方式:<img [src]> 指向静态 URL

html 复制代码
<img [src]="displaySrc" alt="avatar" />
ts 复制代码
get displaySrc(): string {
  return this.avatarUrl ? 'http://localhost:8081' + this.avatarUrl : '';
}
  • <img> 加载图片不受 CORS 限制 ,前端 :4200 直接显示后端 :8081 的图没问题。
  • 后端返回的是相对路径 (/uploads/...),前端拼上后端域名;换环境只改 FILE_BASE。
  • 用属性绑定 [src],不要写 src="{{ ... }}" 也能用,但 [src] 更直观。

6.2 缓存问题:换了头像还显示旧的

方案 做法
✅ 本项目:每次上传用新的随机文件名 URL 变了,浏览器自然重新请求,什么都不用做
固定文件名(如 user-5.png) URL 后加版本号:[src]="url + '?v=' + version",每次上传后更新 version = Date.now()

6.3 兜底:没有头像 / 加载失败

html 复制代码
<!-- 没有头像:显示占位 -->
<img *ngIf="displaySrc; else placeholder" [src]="displaySrc" alt="avatar" (error)="onImgError()" />
<ng-template #placeholder><div class="avatar placeholder">?</div></ng-template>
ts 复制代码
// 图片加载失败(文件被删、网络错误)时触发
onImgError() { this.avatarUrl = ''; }   // 清空后回到占位

用邮箱首字母当占位更好看:

ts 复制代码
get initial(): string { return (this.email[0] ?? '?').toUpperCase(); }

6.4 圆形头像的 CSS

css 复制代码
.avatar { width: 120px; height: 120px; border-radius: 50%; object-fit: cover; }
/* object-fit: cover:图片按比例裁剪填满框,不会被拉伸变形 */

6.5 私有图片(必须登录才能看)

<img src> 没法带 Authorization 头 ,所以如果图片不是公开的,要用 HttpClient(会走 authInterceptor)取成 Blob,再生成本地地址显示。

Service:

ts 复制代码
avatarBlob(path: string) {
  return this.http.get(`${FILE_BASE}${path}`, { responseType: 'blob' });  // 返回 Blob
}

组件:

ts 复制代码
imgSrc = '';

loadPrivateImage(path: string) {
  this.profile.avatarBlob(path).subscribe((blob) => {
    if (this.imgSrc) URL.revokeObjectURL(this.imgSrc);
    this.imgSrc = URL.createObjectURL(blob);   // 然后 <img [src]="imgSrc">
  });
}

后端 :不要用 r.Static(它不鉴权),改成放在 auth 路由组里:

go 复制代码
auth.GET("/files/avatar/:name", func(c *gin.Context) {
	c.File(filepath.Join(uploadDir, filepath.Base(c.Param("name")))) // Base() 防路径穿越
})

头像这类"公开"信息一般用 6.1 就够了;私有文件(身份证照片、合同)才用 6.5。


7. 上传进度条

大文件时显示进度。需要 reportProgress: true + observe: 'events'。

import

ts 复制代码
import { HttpClient, HttpEvent, HttpEventType } from '@angular/common/http';
import { Observable } from 'rxjs';

TS:Service

ts 复制代码
uploadAvatarWithProgress(file: File): Observable<HttpEvent<{ avatarUrl: string }>> {
  const fd = new FormData();
  fd.append('avatar', file);
  return this.http.post<{ avatarUrl: string }>(`${API_URL}/me/avatar`, fd, {
    reportProgress: true,   // 开启进度事件
    observe: 'events',      // 返回的不再只是响应体,而是所有事件流
  });
}

TS:组件

ts 复制代码
progress = 0;

upload() {
  if (!this.selectedFile) return;
  this.uploading = true;
  this.progress = 0;

  this.profile.uploadAvatarWithProgress(this.selectedFile).subscribe({
    next: (event) => {
      if (event.type === HttpEventType.UploadProgress && event.total) {
        this.progress = Math.round((100 * event.loaded) / event.total);   // 0~100
      } else if (event.type === HttpEventType.Response) {
        this.avatarUrl = event.body!.avatarUrl;   // 最后一个事件才是响应
        this.uploading = false;
      }
    },
    error: (err: HttpErrorResponse) => {
      this.uploading = false;
      this.error = this.errorMessage(err);
    },
  });
}

HTML

html 复制代码
<progress *ngIf="uploading" [value]="progress" max="100"></progress>
<span *ngIf="uploading">{{ progress }}%</span>

注意点

  • 本地开发时文件太小,进度一闪而过。测试时用大文件,或在 Chrome DevTools → Network 里把网速限制成 Slow 3G。
  • 用了 observe: 'events' 后,next 会被调用多次,必须用 event.type 区分,不能再当成响应体直接用。

8. 多个页面共享头像

上传后,导航栏的小头像也要立刻变。用 BehaviorSubject 在 service 里存一份,谁上传谁更新,所有订阅者自动刷新。

import

ts 复制代码
import { HttpClient } from '@angular/common/http';
import { Injectable } from '@angular/core';
import { BehaviorSubject, tap } from 'rxjs';

TS:Service

ts 复制代码
@Injectable({ providedIn: 'root' })
export class AvatarStore {
  constructor(private http: HttpClient) {}

  private avatar = new BehaviorSubject<string>('');        // 私有可写
  avatarUrl$ = this.avatar.asObservable();                 // 对外只读

  // 登录后/刷新页面时调用一次,从服务器取
  load() {
    return this.http.get<{ avatarUrl: string }>(`${API_URL}/me`)
      .pipe(tap((me) => this.avatar.next(me.avatarUrl)));
  }

  // 上传/删除成功后调用
  set(url: string) {
    this.avatar.next(url);
  }
}

TS:上传组件里,成功后同步

ts 复制代码
constructor(private profile: ProfileService, private store: AvatarStore) {}

// upload() 的 next 里:
this.store.set(res.avatarUrl);

HTML:导航栏(app.component)

html 复制代码
<!-- 需要 CommonModule(async 管道) -->
<img *ngIf="store.avatarUrl$ | async as url" class="nav-avatar" [src]="fileBase + url" alt="" />
ts 复制代码
// app.component.ts
fileBase = FILE_BASE;
constructor(public store: AvatarStore) {}
ngOnInit() { this.store.load().subscribe(); }   // 已登录时调用

注意点

  • 退出登录时也要 store.set('') 清掉,否则下一个用户短暂看到上一个人的头像。
  • async as url 在空串时为 falsy,*ngIf 不渲染,自然就实现了"没头像不显示"。

9. 文件 + 普通字段一起提交

注册/资料表单常见:既有昵称等文本,又有头像文件。

import

ts 复制代码
import { FormBuilder, ReactiveFormsModule, Validators } from '@angular/forms';

HTML

html 复制代码
<form [formGroup]="form" (ngSubmit)="submit()">
  <input formControlName="nickname" placeholder="昵称" />

  <!-- 文件框不要用 formControlName,它的值是 "C:\fakepath\xx.png" 字符串,不是 File 对象 -->
  <input type="file" accept="image/*" (change)="onFile($event)" />

  <button type="submit">保存</button>
</form>

TS

ts 复制代码
file: File | null = null;   // 文件单独放属性里,不进 FormGroup

form = this.fb.nonNullable.group({
  nickname: ['', Validators.required],
});

constructor(private fb: FormBuilder, private http: HttpClient) {}

onFile(e: Event) {
  this.file = (e.target as HTMLInputElement).files?.[0] ?? null;
}

submit() {
  if (this.form.invalid) { this.form.markAllAsTouched(); return; }

  const fd = new FormData();
  fd.append('nickname', this.form.getRawValue().nickname);   // 文本字段:值必须是 string/Blob
  if (this.file) fd.append('avatar', this.file);             // 文件字段

  this.http.post(`${API_URL}/me/profile`, fd).subscribe({
    next: () => console.log('保存成功'),
    error: (err) => console.error(err),
  });
}

后端 Gin

go 复制代码
func (s *Server) saveProfile(c *gin.Context) {
	nickname := c.PostForm("nickname")        // 同一个 multipart 里的文本字段
	fh, err := c.FormFile("avatar")           // 文件(可选:没传时 err != nil)
	// ...校验 nickname;有文件就走第 3 节的校验与保存流程
}

注意点

  • FormData.append 的值只能是 字符串或 Blob/File :数字要 String(n),对象要 JSON.stringify 后自己在后端解析。
  • 文件框的值不能 绑定到 FormControl(拿不到 File 对象),要用 (change) 读 files。

10. 用 curl 测试后端

不开前端也能验证后端。先注册拿 token:

bash 复制代码
B=http://localhost:8081
TOKEN=$(curl -s -X POST $B/api/register -H 'Content-Type: application/json' \
  -d '{"email":"t@t.com","password":"123456"}' | python3 -c 'import sys,json;print(json.load(sys.stdin)["token"])')
测试 命令 期望
上传成功 curl -s -X POST $B/api/me/avatar -H "Authorization: Bearer $TOKEN" -F avatar=@a.png {"avatarUrl":"/uploads/avatars/xxxx.png"}
没登录 同上但不带 Authorization 401
取回图片 curl -o /dev/null -w '%{http_code} %{content_type}' $B/uploads/avatars/xxxx.png 200 image/png
伪造类型(把文本改名 .png) -F avatar=@fake.png 422 only jpg, png, webp, gif are allowed
超大文件(>2MB) -F avatar=@big.png 422
没传文件 -F x=1 422 avatar file is required
重复上传 再传一次 uploads/avatars/ 里只剩新文件(旧文件被删)
查看 /me curl -s $B/api/me -H "Authorization: Bearer $TOKEN" 含 "avatarUrl"
删除 curl -s -X POST $B/api/me/avatar/delete -H "Authorization: Bearer $TOKEN" {"avatarUrl":""},文件被删
目录列表 curl -o /dev/null -w '%{http_code}' $B/uploads/avatars/ 404(不泄露文件列表)

curl -F avatar=@a.png 就是 multipart 上传,@ 表示从文件读取;curl 会自动设置 Content-Type 和 boundary。


11. 常见坑速查

现象 原因与解决
后端报 request Content-Type isn't multipart/form-data 或 no multipart boundary param in Content-Type 前端手动设置了 Content-Type。删掉,让浏览器自动生成
后端 c.FormFile 报 http: no such file 字段名不一致。前端 append('avatar', ...) 与后端 FormFile("avatar") 必须相同
前端 FormData 上传了但后端收到空 你传的是 file.name 或对象,而不是 File 本身;append 第二个参数要传 File 对象
再次选同一个文件没反应 (change) 只在值变化时触发。读完文件后 input.value = ''
图片地址 404 ① r.Static("/uploads", "./uploads") 没加;② 前端没拼 FILE_BASE(静态文件不在 /api 下);③ 后端是在别的目录启动的,相对路径 ./uploads 对不上
保存时报 no such file or directory 上传目录没创建。启动时 os.MkdirAll(uploadDir, 0o755)
换了头像还显示旧图 固定文件名被浏览器缓存。用随机文件名(本项目做法),或 URL 加 ?v=时间戳
预览用的 blob: 地址一直占内存 不用时 URL.revokeObjectURL;组件销毁时也要释放
[src] 绑定后地址变成 unsafe:... Angular 的 URL 消毒拦截。普通 http/blob: 地址不会;如果是 data: 等特殊地址,用 DomSanitizer.bypassSecurityTrustUrl(确认来源可信才用)
前端校验通过但后端拒绝 正常。后端按文件头 判断真实类型,前端的 file.type 只看扩展名
允许上传 svg 作头像 不要 。svg 里可嵌 <script>,直接访问会被执行(XSS)
数据库存了文件名,磁盘文件没了(或相反) 删除/替换时两边要一起处理:先改库,成功后再删文件;入库失败要把刚存的文件删掉(见 uploadAvatar)
超大文件时前端拿到的错误不稳定 触发 MaxBytesReader 后服务端会中断读取,curl 能收到 422,但浏览器有时会直接得到 status 0(连接被断)。所以前端必须先校验大小,别指望靠后端的错误提示
生产环境 静态文件交给 Nginx / 对象存储(S3、OSS)+ CDN,不要靠 Gin 直接发;存 uploads/ 的磁盘要持久化(容器里要挂卷)
相关推荐
zhanlang021713 分钟前
HTML 零基础入门到企业实战【第七章 表单标签|7.1 表单核心作用:数据收集、用户交互原理】
前端·html·交互
FungLeo28 分钟前
成为全栈·Vue 管理后台篇·Biome、类型检查、构建和API 代理如何组成质量门禁
前端·javascript·vue.js·typescript·vite·前端工程化·biome
夕水1 小时前
受不了满屏广告的诗词网站,以及很多打不开的诗词网站,我干脆自己租服务器用trae重构了一个(纯公益、无广告)
前端·javascript
Brookty1 小时前
HTML基础知识:表格布局、表单数据提交、元素标识与资源相对路径
前端·html
徐小夕1 小时前
开源!我们用知识图谱重构了电子档案,AI 驱动全文智能关联
前端·vue.js·github
不一样的少年_2 小时前
用了这 Skill,前端兄弟都觉得好
前端·后端·ai编程
恋猫de小郭2 小时前
Flutter Native Interop 稳定了,Platform Channel 要退场了
android·前端·flutter
奶油话梅糖2 小时前
容器启停 2.5 毫秒:11 天 1,700 Star 的 Kiri,用一个 900 KB 的 PID 1 干掉了 runc 和 dockerd
前端·人工智能·rust