\u95ee\u9898\u4f4d\u7f6e：\u8bf7\u6c42\u5728\u5230\u8fbe\u5e94\u7528\u4ee3\u7801\u4e4b\u524d\u5c31\u88ab\u670d\u52a1\u5668\u62e6\u622a\u4e86<\/li>\n<\/ul>\n\u5b8c\u6574\u89e3\u51b3\u65b9\u6848<\/h3>\n\u7b2c\u4e00\u90e8\u5206：\u540e\u7aefSpring Boot\u5e94\u7528\u914d\u7f6e<\/h4>\n1. \u4fee\u6539Spring Boot\u914d\u7f6e\u6587\u4ef6<\/h5>\n
application.properties（\u63a8\u8350）<\/p>\n
# ========== \u6587\u4ef6\u4e0a\u4f20\u914d\u7f6e ==========
\n# \u5355\u4e2a\u6587\u4ef6\u7684\u6700\u5927\u5927\u5c0f（\u9ed8\u8ba41MB）
\nspring.servlet.multipart.max-file-size=50MB<\/p>\n
# \u6574\u4e2a\u8bf7\u6c42\u7684\u6700\u5927\u5927\u5c0f（\u9ed8\u8ba410MB）
\nspring.servlet.multipart.max-request-size=100MB<\/p>\n
# ========== Undertow\u670d\u52a1\u5668\u4e13\u7528\u914d\u7f6e ==========
\n# \u8fd9\u662f\u89e3\u51b3\u56fe\u4e2d\u9519\u8bef\u7684\u5173\u952e\u914d\u7f6e！
\nserver.undertow.max-http-post-size=100MB<\/p>\n
# ========== \u5176\u4ed6\u53ef\u9009\u4f18\u5316\u914d\u7f6e ==========
\n# \u8bbe\u7f6e\u4e34\u65f6\u6587\u4ef6\u5b58\u50a8\u4f4d\u7f6e（\u53ef\u9009）
\nspring.servlet.multipart.location=\/tmp<\/p>\n
# \u662f\u5426\u5ef6\u8fdf\u89e3\u6790（\u5927\u6587\u4ef6\u5efa\u8bae\u8bbe\u4e3atrue）
\nspring.servlet.multipart.resolve-lazily=false <\/p>\n
application.yml<\/p>\n
spring:
\n servlet:
\n multipart:
\n max-file-size: 50MB
\n max-request-size: 100MB
\n location: \/tmp
\n resolve-lazily: false<\/p>\n
server:
\n undertow:
\n max-http-post-size: 100MB <\/p>\n
2. \u521b\u5efa\u914d\u7f6e\u9a8c\u8bc1\u63a5\u53e3（\u53ef\u9009\u4f46\u63a8\u8350）<\/h5>\n
import org.springframework.beans.factory.annotation.Value;
\nimport org.springframework.web.bind.annotation.GetMapping;
\nimport org.springframework.web.bind.annotation.RestController;<\/p>\n
@RestController
\npublic class ConfigInfoController {<\/p>\n
@Value("${spring.servlet.multipart.max-file-size}")
\n private String maxFileSize;<\/p>\n
@Value("${spring.servlet.multipart.max-request-size}")
\n private String maxRequestSize;<\/p>\n
@Value("${server.undertow.max-http-post-size}")
\n private String undertowMaxPostSize;<\/p>\n
@GetMapping("\/config\/info")
\n public String getConfigInfo() {
\n return String.format(
\n "\u5f53\u524d\u6587\u4ef6\u4e0a\u4f20\u914d\u7f6e：<br>" +
\n "\u2022 Spring Multipart \u5355\u4e2a\u6587\u4ef6\u6700\u5927：%s<br>" +
\n "\u2022 Spring Multipart \u8bf7\u6c42\u6700\u5927：%s<br>" +
\n "\u2022 Undertow POST\u8bf7\u6c42\u6700\u5927：%s<br><br>" +
\n "\u914d\u7f6e\u9a8c\u8bc1：%s",
\n maxFileSize,
\n maxRequestSize,
\n undertowMaxPostSize,
\n verifyConfig() ? "\u2705 \u914d\u7f6e\u5408\u7406" : "\u26a0\ufe0f \u914d\u7f6e\u53ef\u80fd\u6709\u51b2\u7a81"
\n );
\n }<\/p>\n
private boolean verifyConfig() {
\n \/\/ \u9a8c\u8bc1Undertow\u914d\u7f6e\u662f\u5426\u8db3\u591f\u5927
\n long undertowSize = parseSize(undertowMaxPostSize);
\n long requestSize = parseSize(maxRequestSize);
\n return undertowSize >= requestSize;
\n }<\/p>\n
private long parseSize(String sizeStr) {
\n \/\/ \u7b80\u5355\u89e3\u6790\u5927\u5c0f\u5b57\u7b26\u4e32，\u5b9e\u9645\u53ef\u4f7f\u7528\u66f4\u5b8c\u6574\u7684\u65b9\u6cd5
\n if (sizeStr.endsWith("MB")) {
\n return Long.parseLong(sizeStr.replace("MB", "")) * 1024 * 1024;
\n }
\n return Long.parseLong(sizeStr);
\n }
\n} <\/p>\n
3. \u6dfb\u52a0\u5168\u5c40\u5f02\u5e38\u5904\u7406\u5668<\/h5>\n
import org.slf4j.Logger;
\nimport org.slf4j.LoggerFactory;
\nimport org.springframework.http.HttpStatus;
\nimport org.springframework.http.ResponseEntity;
\nimport org.springframework.web.bind.annotation.ControllerAdvice;
\nimport org.springframework.web.bind.annotation.ExceptionHandler;
\nimport org.springframework.web.multipart.MaxUploadSizeExceededException;
\nimport io.undertow.server.RequestTooBigException;<\/p>\n
@ControllerAdvice
\npublic class FileUploadExceptionHandler {<\/p>\n
private static final Logger logger = LoggerFactory.getLogger(FileUploadExceptionHandler.class);<\/p>\n
@ExceptionHandler({
\n MaxUploadSizeExceededException.class,
\n RequestTooBigException.class,
\n IllegalStateException.class
\n })
\n public ResponseEntity<ApiResponse> handleFileSizeException(Exception ex) {<\/p>\n
\/\/ \u8bb0\u5f55\u8be6\u7ec6\u9519\u8bef\u65e5\u5fd7
\n logger.error("========== \u6587\u4ef6\u4e0a\u4f20\u5927\u5c0f\u5f02\u5e38 ==========");
\n logger.error("\u5f02\u5e38\u7c7b\u578b: " + ex.getClass().getName());
\n logger.error("\u5f02\u5e38\u4fe1\u606f: " + ex.getMessage());
\n logger.error("\u5806\u6808\u8ddf\u8e2a:", ex);
\n logger.error("======================================");<\/p>\n
\/\/ \u6839\u636e\u5f02\u5e38\u7c7b\u578b\u63d0\u4f9b\u66f4\u5177\u4f53\u7684\u9519\u8bef\u4fe1\u606f
\n String userMessage;
\n String techMessage = ex.getMessage();<\/p>\n
if (ex instanceof RequestTooBigException) {
\n userMessage = "\u4e0a\u4f20\u5931\u8d25：\u6587\u4ef6\u5927\u5c0f\u8d85\u8fc7\u670d\u52a1\u5668\u9650\u5236（\u5f53\u524d\u6700\u592720MB）";
\n } else if (ex instanceof MaxUploadSizeExceededException) {
\n userMessage = "\u4e0a\u4f20\u5931\u8d25：\u6587\u4ef6\u5927\u5c0f\u8d85\u8fc7\u5e94\u7528\u9650\u5236";
\n } else if (ex.getMessage() != null && ex.getMessage().contains("was larger than")) {
\n userMessage = "\u4e0a\u4f20\u5931\u8d25：\u8bf7\u6c42\u4f53\u5927\u5c0f\u8d85\u51fa\u9650\u5236";
\n } else {
\n userMessage = "\u4e0a\u4f20\u5931\u8d25：\u6587\u4ef6\u5904\u7406\u5f02\u5e38";
\n }<\/p>\n
\/\/ \u8fd4\u56de\u6807\u51c6\u5316\u9519\u8bef\u54cd\u5e94
\n ApiResponse response = ApiResponse.error(
\n HttpStatus.PAYLOAD_TOO_LARGE.value(),
\n userMessage,
\n techMessage
\n );<\/p>\n
return ResponseEntity
\n .status(HttpStatus.PAYLOAD_TOO_LARGE)
\n .body(response);
\n }<\/p>\n
\/\/ \u7edf\u4e00\u54cd\u5e94\u683c\u5f0f
\n public static class ApiResponse {
\n private int code;
\n private String message;
\n private String detail;
\n private Object data;<\/p>\n
\/\/ \u6784\u9020\u65b9\u6cd5\u3001getter\/setter \u7701\u7565<\/p>\n
public static ApiResponse error(int code, String message, String detail) {
\n ApiResponse response = new ApiResponse();
\n response.setCode(code);
\n response.setMessage(message);
\n response.setDetail(detail);
\n return response;
\n }
\n }
\n} <\/p>\n
\u7b2c\u4e8c\u90e8\u5206：Nginx\u4ee3\u7406\u914d\u7f6e（\u5982\u679c\u4f7f\u7528）<\/h4>\n
\u5982\u679c\u60a8\u7684\u5e94\u7528\u524d\u9762\u6709Nginx\u4ee3\u7406，\u5fc5\u987b\u540c\u65f6\u914d\u7f6eNginx：<\/p>\n
1. \u4fee\u6539Nginx\u914d\u7f6e\u6587\u4ef6<\/h5>\n
# \/etc\/nginx\/nginx.conf \u6216\u7ad9\u70b9\u914d\u7f6e\u6587\u4ef6
\nhttp {
\n # \u9ed8\u8ba4\u7684\u5ba2\u6237\u7aef\u8bf7\u6c42\u4f53\u5927\u5c0f\u9650\u5236（\u9ed8\u8ba41MB）
\n client_max_body_size 100M;<\/p>\n
# \u5176\u4ed6http\u914d\u7f6e…
\n}<\/p>\n
server {
\n listen 80;
\n server_name your-domain.com;<\/p>\n
# \u9488\u5bf9\u5f53\u524dserver\u7684\u914d\u7f6e（\u4f1a\u8986\u76d6http\u5757\u4e2d\u7684\u8bbe\u7f6e）
\n client_max_body_size 100M;<\/p>\n
# \u4e0a\u4f20\u63a5\u53e3\u7684\u7279\u6b8a\u914d\u7f6e（\u5982\u679c\u4e0a\u4f20\u8def\u5f84\u56fa\u5b9a）
\n location \/api\/upload {
\n # \u53ef\u4ee5\u5355\u72ec\u4e3a\u4e0a\u4f20\u63a5\u53e3\u8bbe\u7f6e\u66f4\u5927\u7684\u9650\u5236
\n client_max_body_size 200M;<\/p>\n
# \u589e\u52a0\u8d85\u65f6\u65f6\u95f4（\u5927\u6587\u4ef6\u4e0a\u4f20\u9700\u8981）
\n proxy_connect_timeout 300s;
\n proxy_send_timeout 300s;
\n proxy_read_timeout 300s;<\/p>\n
# \u4ee3\u7406\u5230\u540e\u7aef\u5e94\u7528
\n proxy_pass http:\/\/localhost:8080;
\n proxy_set_header Host $host;
\n proxy_set_header X-Real-IP $remote_addr;
\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
\n proxy_set_header X-Forwarded-Proto $scheme;
\n }<\/p>\n
# \u5176\u4ed6location\u914d\u7f6e…
\n location \/ {
\n proxy_pass http:\/\/localhost:8080;
\n # \u5176\u4ed6\u4ee3\u7406\u8bbe\u7f6e…
\n }
\n} <\/p>\n
2. \u9a8c\u8bc1\u5e76\u91cd\u542fNginx<\/h5>\n
# 1. \u68c0\u67e5\u914d\u7f6e\u6587\u4ef6\u8bed\u6cd5
\nsudo nginx -t<\/p>\n
# 2. \u5982\u679c\u8bed\u6cd5\u6b63\u786e，\u91cd\u65b0\u52a0\u8f7d\u914d\u7f6e
\nsudo nginx -s reload<\/p>\n
# \u6216\u91cd\u542fNginx\u670d\u52a1
\nsudo systemctl restart nginx<\/p>\n
# 3. \u67e5\u770bNginx\u9519\u8bef\u65e5\u5fd7（\u5982\u679c\u4ecd\u6709\u95ee\u9898）
\nsudo tail -f \/var\/log\/nginx\/error.log <\/p>\n
\u7b2c\u4e09\u90e8\u5206：\u524d\u7aef\u4f18\u5316\u914d\u7f6e<\/h4>\n1. HTML\u524d\u7aef\u9a8c\u8bc1<\/h5>\n
<!DOCTYPE html>
\n<html>
\n<head>
\n <title>\u6587\u4ef6\u4e0a\u4f20<\/title>
\n <style>
\n .file-input {
\n padding: 10px;
\n border: 2px dashed #ccc;
\n border-radius: 5px;
\n margin: 20px 0;
\n }
\n .error {
\n color: #f00;
\n margin-top: 5px;
\n }
\n .file-info {
\n color: #666;
\n font-size: 0.9em;
\n }
\n <\/style>
\n<\/head>
\n<body>
\n <h2>\u6587\u4ef6\u4e0a\u4f20<\/h2><\/p>\n
<form id="uploadForm" method="post" enctype="multipart\/form-data" action="\/api\/upload">
\n <div>
\n <label for="file">\u9009\u62e9\u6587\u4ef6：<\/label>
\n <input type="file" id="file" name="file" class="file-input"
\n accept=".jpg,.jpeg,.png,.pdf,.doc,.docx,.xls,.xlsx">
\n <\/div><\/p>\n
<div id="fileInfo" class="file-info"><\/div>
\n <div id="errorMsg" class="error"><\/div><\/p>\n
<button type="submit" id="submitBtn">\u4e0a\u4f20\u6587\u4ef6<\/button>
\n <\/form><\/p>\n
<script>
\n const MAX_FILE_SIZE = 20 * 1024 * 1024; \/\/ 20MB<\/p>\n
document.getElementById('file').addEventListener('change', function(e) {
\n const file = e.target.files[0];
\n const errorDiv = document.getElementById('errorMsg');
\n const infoDiv = document.getElementById('fileInfo');<\/p>\n
\/\/ \u6e05\u7a7a\u4e4b\u524d\u7684\u63d0\u793a
\n errorDiv.textContent = '';
\n infoDiv.textContent = '';<\/p>\n
if (!file) return;<\/p>\n
\/\/ \u663e\u793a\u6587\u4ef6\u4fe1\u606f
\n const fileSizeMB = (file.size \/ (1024 * 1024)).toFixed(2);
\n infoDiv.textContent = `\u6587\u4ef6: ${file.name} (${fileSizeMB} MB)`;<\/p>\n
\/\/ \u68c0\u67e5\u6587\u4ef6\u5927\u5c0f
\n if (file.size > MAX_FILE_SIZE) {
\n const maxSizeMB = (MAX_FILE_SIZE \/ (1024 * 1024)).toFixed(0);
\n errorDiv.textContent = `\u9519\u8bef：\u6587\u4ef6\u5927\u5c0f\u4e0d\u80fd\u8d85\u8fc7 ${maxSizeMB}MB`;
\n e.target.value = ''; \/\/ \u6e05\u7a7a\u9009\u62e9
\n infoDiv.textContent = '';
\n }
\n });<\/p>\n
\/\/ \u8868\u5355\u63d0\u4ea4\u524d\u518d\u6b21\u9a8c\u8bc1
\n document.getElementById('uploadForm').addEventListener('submit', function(e) {
\n const fileInput = document.getElementById('file');
\n const errorDiv = document.getElementById('errorMsg');<\/p>\n
if (!fileInput.files[0]) {
\n errorDiv.textContent = '\u8bf7\u9009\u62e9\u8981\u4e0a\u4f20\u7684\u6587\u4ef6';
\n e.preventDefault();
\n return false;
\n }<\/p>\n
if (fileInput.files[0].size > MAX_FILE_SIZE) {
\n errorDiv.textContent = '\u6587\u4ef6\u5927\u5c0f\u8d85\u8fc7\u9650\u5236，\u8bf7\u91cd\u65b0\u9009\u62e9';
\n e.preventDefault();
\n return false;
\n }<\/p>\n
\/\/ \u663e\u793a\u4e0a\u4f20\u4e2d\u72b6\u6001
\n const submitBtn = document.getElementById('submitBtn');
\n submitBtn.disabled = true;
\n submitBtn.textContent = '\u4e0a\u4f20\u4e2d…';<\/p>\n
return true;
\n });
\n <\/script>
\n<\/body>
\n<\/html> <\/p>\n
2. React\u7ec4\u4ef6\u793a\u4f8b（\u5982\u679c\u4f7f\u7528React）<\/h5>\n
import React, { useState } from 'react';
\nimport axios from 'axios';<\/p>\n
const FileUploadComponent = () => {
\n const [file, setFile] = useState(null);
\n const [error, setError] = useState('');
\n const [uploading, setUploading] = useState(false);
\n const [progress, setProgress] = useState(0);<\/p>\n
const MAX_SIZE = 20 * 1024 * 1024; \/\/ 20MB<\/p>\n
const handleFileChange = (e) => {
\n const selectedFile = e.target.files[0];
\n setError('');<\/p>\n
if (!selectedFile) return;<\/p>\n
\/\/ \u68c0\u67e5\u6587\u4ef6\u5927\u5c0f
\n if (selectedFile.size > MAX_SIZE) {
\n setError(`\u6587\u4ef6\u5927\u5c0f\u4e0d\u80fd\u8d85\u8fc7 ${MAX_SIZE \/ (1024 * 1024)}MB`);
\n setFile(null);
\n e.target.value = '';
\n return;
\n }<\/p>\n
setFile(selectedFile);
\n };<\/p>\n
const handleUpload = async () => {
\n if (!file) {
\n setError('\u8bf7\u5148\u9009\u62e9\u6587\u4ef6');
\n return;
\n }<\/p>\n
const formData = new FormData();
\n formData.append('file', file);<\/p>\n
try {
\n setUploading(true);
\n setProgress(0);<\/p>\n
const response = await axios.post('\/api\/upload', formData, {
\n headers: {
\n 'Content-Type': 'multipart\/form-data'
\n },
\n onUploadProgress: (progressEvent) => {
\n const percent = Math.round(
\n (progressEvent.loaded * 100) \/ progressEvent.total
\n );
\n setProgress(percent);
\n }
\n });<\/p>\n
alert('\u4e0a\u4f20\u6210\u529f！');
\n setFile(null);
\n setProgress(0);<\/p>\n
} catch (err) {
\n if (err.response && err.response.status === 413) {
\n setError('\u6587\u4ef6\u592a\u5927，\u8bf7\u538b\u7f29\u540e\u91cd\u65b0\u4e0a\u4f20');
\n } else {
\n setError('\u4e0a\u4f20\u5931\u8d25: ' + (err.response?.data?.message || err.message));
\n }
\n } finally {
\n setUploading(false);
\n }
\n };<\/p>\n
return (
\n <div>
\n <input type="file" onChange={handleFileChange} disabled={uploading} \/>
\n {file && (
\n <div>
\n <p>\u5df2\u9009\u62e9: {file.name} ({(file.size \/ (1024 * 1024)).toFixed(2)} MB)<\/p>
\n <\/div>
\n )}
\n {error && <div style={{color: 'red'}}>{error}<\/div>}
\n {uploading && (
\n <div>
\n <progress value={progress} max="100" \/>
\n <span>{progress}%<\/span>
\n <\/div>
\n )}
\n <button onClick={handleUpload} disabled={uploading || !file}>
\n {uploading ? '\u4e0a\u4f20\u4e2d…' : '\u4e0a\u4f20\u6587\u4ef6'}
\n <\/button>
\n <\/div>
\n );
\n}; <\/p>\n
\u7b2c\u56db\u90e8\u5206：\u9a8c\u8bc1\u548c\u6d4b\u8bd5<\/h4>\n1. \u521b\u5efa\u6d4b\u8bd5\u63a5\u53e3<\/h5>\n
import org.springframework.web.bind.annotation.*;
\nimport org.springframework.web.multipart.MultipartFile;
\nimport java.io.IOException;<\/p>\n
@RestController
\n@RequestMapping("\/api\/test")
\npublic class UploadTestController {<\/p>\n
@PostMapping("\/upload")
\n public String testUpload(
\n @RequestParam("file") MultipartFile file,
\n @RequestParam(value = "chunk", required = false) Integer chunk,
\n @RequestParam(value = "chunks", required = false) Integer chunks) {<\/p>\n
System.out.println("=== \u6587\u4ef6\u4e0a\u4f20\u6d4b\u8bd5 ===");
\n System.out.println("\u6587\u4ef6\u540d: " + file.getOriginalFilename());
\n System.out.println("\u6587\u4ef6\u5927\u5c0f: " + file.getSize() + " \u5b57\u8282");
\n System.out.println("\u6587\u4ef6\u7c7b\u578b: " + file.getContentType());<\/p>\n
if (chunk != null && chunks != null) {
\n System.out.println("\u5206\u7247\u4e0a\u4f20: " + (chunk + 1) + "\/" + chunks);
\n }<\/p>\n
\/\/ \u8fd4\u56de\u4e0a\u4f20\u4fe1\u606f
\n return String.format(
\n "\u4e0a\u4f20\u6210\u529f！\\\\n" +
\n "\u6587\u4ef6\u540d: %s\\\\n" +
\n "\u5927\u5c0f: %.2f MB\\\\n" +
\n "\u7c7b\u578b: %s",
\n file.getOriginalFilename(),
\n file.getSize() \/ (1024.0 * 1024.0),
\n file.getContentType()
\n );
\n }<\/p>\n
@GetMapping("\/limits")
\n public String getLimits() {
\n return "\u5f53\u524d\u6d4b\u8bd5\u63a5\u53e3\u53ef\u7528，\u8bf7\u4f7f\u7528Postman\u6216\u524d\u7aef\u9875\u9762\u4e0a\u4f20\u6587\u4ef6\u8fdb\u884c\u6d4b\u8bd5";
\n }
\n} <\/p>\n
2. \u4f7f\u7528Postman\u6d4b\u8bd5<\/h5>\n
![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/02\/20260212214307-698e496b01fc1.png\")
<\/p>\n