Flutter Web中向Firebase Firestore存储Timestamp报错,移动端正常
Flutter Web 端 Firebase Firestore Timestamp 写入异常问题
基础现象
- 同一业务逻辑在 Android、iOS 端运行完全正常
- Flutter Web 端调用 Firestore 写入时,所有 Timestamp 相关操作触发报错
已尝试的排查操作
- 直接使用
FieldValue.serverTimestamp()赋值 - 传入本地生成的
DateTime.now()对象 - 调用
Timestamp.now()生成时间戳对象传入 - 基于微秒级时间戳手动转换为 Timestamp 类型传入
原有业务代码
baseOEC.set({'comentarios': FieldValue.arrayUnion([ { 'comentario': _comentarios.text, // 该方法在移动端正常运行 'data': FieldValue.serverTimestamp(), 'user': widget.user } ])}, SetOptions(merge: true));
运行报错栈
Error: [cloud_firestore/unknown] Invalid argument (dartObject): Could not convert: Instance of '_FieldValueServerTimestamp' at Object.throw_ [as throw] (http://localhost:62147/dart_sdk.js:4354:11) at document_reference_web.DocumentReferenceWeb.new.set (http://localhost:62147/packages/cloud_firestore_web/src/write_batch_web.dart.lib.js:615:21) at set.next (<anonymous>) at runBody (http://localhost:62147/dart_sdk.js:38020:34) at Object._async [as async] (http://localhost:62147/dart_sdk.js:38051:7) at document_reference_web.DocumentReferenceWeb.new.set (http://localhost:62147/packages/cloud_firestore_web/src/write_batch_web.dart.lib.js:610:20) at cloud_firestore.DocumentReference.__.set (http://localhost:62147/packages/cloud_firestore/cloud_firestore.dart.lib.js:617:31) at detalhes_oec_stream._DetalhesOecStreamState.new.<anonymous> (http://localhost:62147/packages/enterprise/screens/detalhes_oec_stream.dart.lib.js:3684:45) at Generator.next (<anonymous>) at runBody (http://localhost:62147/dart_sdk.js:38020:34) at Object._async [as async] (http://localhost:62147/dart_sdk.js:38051:7) at http://localhost:62147/packages/enterprise/screens/detalhes_oec_stream.dart.lib.js:3682:847 at ink_well._InkResponseState.new.[_handleTap] (http://localhost:62147/packages/flutter/src/material/icon_button.dart.lib.js:51103:42) at tap.TapGestureRecognizer.new.invokeCallback (http://localhost:62147/packages/flutter/src/gestures/recognizer.dart.lib.js:189:18) at tap.TapGestureRecognizer.new.handleTapUp (http://localhost:62147/packages/flutter/src/gestures/tap.dart.lib.js:395:40) at tap.TapGestureRecognizer.new.[_checkUp] (http://localhost:62147/packages/flutter/src/gestures/tap.dart.lib.js:201:12) at tap.TapGestureRecognizer.new.acceptGesture (http://localhost:62147/packages/flutter/src/gestures/arena.dart.lib.js:178:23) at arena.GestureArenaManager.new.sweep (http://localhost:62147/packages/flutter/src/gestures/arena.dart.lib.js:208:31) at binding$5.WidgetsFlutterBinding.new.handleEvent (http://localhost:62147/packages/flutter/src/gestures/binding.dart.lib.js:318:27) at binding$5.WidgetsFlutterBinding.new.dispatchEvent (http://localhost:62147/packages/flutter/src/gestures/binding.dart.lib.js:297:24) at binding$5.WidgetsFlutterBinding.new.dispatchEvent (http://localhost:62147/packages/flutter/src/rendering/layer.dart.lib.js:6087:13) at binding$5.WidgetsFlutterBinding.new.[_handlePointerEventImmediately] (http://localhost:62147/packages/flutter/src/gestures/binding.dart.lib.js:268:14) at binding$5.WidgetsFlutterBinding.new.handlePointerEvent (http://localhost:62147/packages/flutter/src/gestures/binding.dart.lib.js:241:43) at binding$5.WidgetsFlutterBinding.new.[_flushPointerEventQueue] (http://localhost:62147/packages/flutter/src/gestures/binding.dart.lib.js:230:14) at binding$5.WidgetsFlutterBinding.new.[_handlePointerDataPacket] (http://localhost:62147/packages/flutter/src/gestures/binding.dart.lib.js:220:65) at Object.invoke1 (http://localhost:62147/dart_sdk.js:181069:7) at _engine.EnginePlatformDispatcher.__.invokeOnPointerDataPacket (http://localhost:62147/dart_sdk.js:163043:15) at _engine.PointerBinding.__.[_onPointerData] (http://localhost:62147/dart_sdk.js:163678:49) at http://localhost:62147/dart_sdk.js:164111:26 at http://localhost:62147/dart_sdk.js:164070:16 at http://localhost:62147/dart_sdk.js:163778:11
问题定位与修复方案
该报错是cloud_firestore_web 插件版本兼容缺陷导致,核心问题是旧版本插件无法正确转译嵌套在 arrayUnion 操作符内部的 FieldValue 类型对象,原生端实现没有该问题。
修复方案
优先升级插件版本
将cloud_firestore、cloud_firestore_web依赖同步升级到 4.0.0 及以上稳定版本,该分支已修复嵌套场景下的 FieldValue 转译逻辑问题。升级后执行flutter clean && flutter pub get清理缓存即可恢复正常。低版本临时兼容方案
若暂时无法升级依赖,可修改写入逻辑,避免在嵌套 Map 中直接使用FieldValue.serverTimestamp():baseOEC.set({'comentarios': FieldValue.arrayUnion([ { 'comentario': _comentarios.text, // 替换为本地生成的 Timestamp 对象 'data': Timestamp.fromDate(DateTime.now()), 'user': widget.user } ])}, SetOptions(merge: true));若需严格使用服务端时间,可将带
FieldValue.serverTimestamp()的字段单独放在文档顶层,后续再通过事务合并到嵌套数组中。
内容的提问来源于stack exchange,提问作者Ivan Kastorsky
相关产品推荐
相关产品推荐

