文件上传笔记:以「上传头像」为例
前端:Angular 16(standalone) · 后端:Go + Gin + SQLite(与
cart-api同一套结构) 覆盖:选择文件 → 前端校验 → 预览 → 上传 → 后端校验与保存 → 入库 → 展示 → 替换/删除。 本篇独立成篇 :不依赖ANGULAR-NOTES.md,每个小节都带 import / HTML / TS(或 Go)。 文中的 Go 代码已在 Gin 1.10 + SQLite 下用 curl 实测通过,前端代码已通过 Angular 严格模板编译检查。
目录
- 整体流程
- 数据库表的定义
- [后端 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")
- [前端:Service(发送 FormData)](#前端:Service(发送 FormData) "#4-%E5%89%8D%E7%AB%AFservicedformdata")
- 前端:组件(选择、校验、预览、上传、展示)
- 头像怎么展示(缓存、兜底、样式、私有图片)
- 上传进度条
- 多个页面共享头像(导航栏同步刷新)
- [文件 + 普通字段一起提交(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")
- [用 curl 测试后端](#用 curl 测试后端 "#10-%E7%94%A8-curl-%E6%B5%8B%E8%AF%95%E5%90%8E%E7%AB%AF")
- 常见坑速查
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/ 的磁盘要持久化(容器里要挂卷) |