画面で約束していることを、支えていたのは他人のライブラリの実装詳細だった

// EXIF（GPS・撮影機材・撮影日時など）を必ず剥がす。再エンコードだけでは消えない
// ＝image パッケージは decodeImage→encodeJpg でメタデータを round-trip させるため、
// 縮小しない小さい画像はそのまま位置情報まで web へ同梱されてしまう（テストで実証）。
// 先に bakeOrientation で回転を画素へ焼いてから消す。向きの情報も EXIF なので、
// 消すだけだと縦で撮った写真がアップ後に横向きで出る。
final out = img.bakeOrientation(resized);
out.exif = img.ExifData();                              // ← 付箋を空にして貼り直す
return Uint8List.fromList(img.encodeJpg(out, quality: quality));

Future<Uint8List?> resolveJpegBytes(Photo photo) async {
  if (PlatformUtils.isDesktopOS) {
    // ...ファイルを読んで...
    return resizeToJpeg(await file.readAsBytes());        // ← 剥がす
  }
  // スマホ側
  final asset = await AssetEntity.fromId(id);
  return asset.thumbnailDataWithSize(                      // ← 剥がさない
    const ThumbnailSize(1920, 1920), quality: 88);
}

@override
Future<Uint8List?> resolveJpegBytes(Photo photo) async {
  final raw = await _readRawBytes(photo);
  if (raw == null) return null;
  return resizeToJpeg(raw);              // ← 出口はここだけ
}
 
/// 端末から生バイトを読むだけ。ここから返る値は必ず未処理＝剥がしは呼び出し元。
Future<Uint8List?> _readRawBytes(Photo photo) async {
  if (PlatformUtils.isDesktopOS) { /* ファイルを読む */ }
  /* サムネイルを取る */
}

final out = await const DefaultPhotoBytesResolver()      // resolver の実体を作る
    .resolveJpegBytes(await insertPhotoAt(file.path));   // ← 出口の戻り値そのものを取る
 
// expect(調べたい値, 期待する結果) の形で書く
expect(out, isNotNull);                                   // out が null でないことを期待
final outExif = img.decodeJpgExif(out!);                 // 出てきた JPEG から付箋を読む
expect(outExif == null || outExif.isEmpty, isTrue,       // 付箋ごと無い / 箱はあるが空、どちらもOK
    reason: 'resolver の戻り値に EXIF が残ってはいけない');  // 落ちた時に出る一言

test('生バイトを読む口は _readRawBytes だけで、出口は resizeToJpeg 1本', () {
  final source = File('lib/core/upload/photo_bytes_resolver.dart')  // 動かす相手ではなく、読む相手として開く
      .readAsLinesSync()                                   // ファイルを1行ずつの配列にする
      .where((line) => !line.trimLeft().startsWith('//'))  // コメント行を捨てる（doc の経緯文に API 名が出てくるので）
      .join('\n');                                         // 残りを1本の文字列に戻す。以降はこれを検索する
 
  final readerIndex = source.indexOf('_readRawBytes(Photo photo)');  // 読み取り関数が先頭から何文字目に出るか
  expect(readerIndex, greaterThan(0),                      // 0 より大きい＝見つかった（無ければ -1 が返る）
      reason: '読み取り関数の名前が変わった');               // 落ちた時に出る一言。名前が変わった合図
 
  for (final api in ['thumbnailDataWithSize', 'readAsBytes']) {  // 端末から生バイトを読む API は この2つ
    expect(source.indexOf(api), greaterThan(readerIndex),  // その API が読み取り関数より「後ろ」にしか無い
        reason: '$api が _readRawBytes の外に出ている＝剥がしを迂回する経路ができた');  // 前に出たらこれ
  }
 
  expect('resizeToJpeg('.allMatches(source).length, 1,     // 剥がしの呼び出しがファイル全体で何回あるか
      reason: '剥がしの呼び出しが増えた＝出口が1本でなくなった');  // 1 でなければ出口が増えている
});