You need to enable JavaScript to run this app. Flutter中如何同时上传文本框输入内容与选中的图片?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.10 01:18:02