Flutter中如何同时上传文本框输入内容与选中的图片?
Flutter 实现相册选图+文本图片同步上传完整方案
1. 前置依赖安装
首先在pubspec.yaml中添加以下依赖:
dependencies: flutter: sdk: flutter image_picker: ^1.0.4 # 用于调取系统相册选图 dio: ^5.4.0 # 用于网络请求/文件上传 path: ^1.8.3 # 用于获取图片文件名
执行flutter pub get完成依赖安装。
2. 平台权限配置
Android
在android/app/src/main/AndroidManifest.xml的<manifest>标签下添加存储权限:
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" /> <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
iOS
在ios/Runner/Info.plist的<dict>标签下添加相册访问权限说明:
<key>NSPhotoLibraryUsageDescription</key> <string>需要访问相册选取上传的图片</string>
3. 核心功能实现
import 'package:flutter/material.dart'; import 'package:image_picker/image_picker.dart'; import 'package:dio/dio.dart'; import 'package:path/path.dart' as path; class ImageUploadPage extends StatefulWidget { const ImageUploadPage({super.key}); @override State<ImageUploadPage> createState() => _ImageUploadPageState(); } class _ImageUploadPageState extends State<ImageUploadPage> { final TextEditingController _contentController = TextEditingController(); XFile? _selectedImage; final ImagePicker _picker = ImagePicker(); final Dio _dio = Dio(); // 从相册选取图片 Future<void> _pickImage() async { final XFile? pickedFile = await _picker.pickImage(source: ImageSource.gallery); if (pickedFile != null) { setState(() { _selectedImage = pickedFile; // 将图片名称填充到文本框 _contentController.text = path.basename(pickedFile.path); }); } } // 上传文本和图片到服务端 Future<void> _uploadData() async { if (_contentController.text.isEmpty) { ScaffoldMessenger.of(context).showSnackBar(const SnackBar(content: Text('请输入内容或选择图片'))); return; } try { final formData = FormData.fromMap({ // 文本字段,字段名可根据服务端要求修改 'content': _contentController.text, if (_selectedImage != null) // 图片字段,字段名可根据服务端要求修改 'image': await MultipartFile.fromFile( _selectedImage!.path, filename: path.basename(_selectedImage!.path), ), }); // 替换为你的服务端上传接口地址 final response = await _dio.post('https://your-server-api.com/upload', data: formData); if (response.statusCode == 200) { ScaffoldMessenger.of(context).showSnackBar(const SnackBar(content: Text('上传成功'))); } } catch (e) { ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('上传失败:${e.toString()}'))); } } @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar(title: const Text('图片上传示例')), body: Padding( padding: const EdgeInsets.all(16), child: Column( children: [ TextField( controller: _contentController, decoration: const InputDecoration(hintText: '请输入内容', border: OutlineInputBorder()), maxLines: 3, ), const SizedBox(height: 16), Row( mainAxisAlignment: MainAxisAlignment.spaceEvenly, children: [ ElevatedButton( onPressed: _pickImage, child: const Text('从相册选图'), ), ElevatedButton( onPressed: _uploadData, child: const Text('发送上传'), ), ], ), if (_selectedImage != null) Padding( padding: const EdgeInsets.only(top: 16), child: Image.network(_selectedImage!.path, height: 200), ) ], ), ), ); } }
4. 注意事项
- 代码中的
content、image字段名需要和服务端接口定义的接收字段保持一致 - 安卓13及以上版本无需动态申请存储权限,低版本需要在调用选图方法前主动申请权限,可配合
permission_handler包实现 - 上传大图片时可添加分片上传、进度监听的逻辑优化体验
内容的提问来源于stack exchange,提问作者user14845259
相关产品推荐
相关产品推荐

