[Bug report] `kCMPhotoError_InvalidData`

[landfound]

Version

2.4.0

Platforms

iOS

Device Model

iPhone12 mini iOS 26.2

flutter info

[✓] Flutter (Channel stable, 3.38.7, on macOS 15.7.3 24G419 darwin-x64, locale en-CN) [1,734ms]
    • Flutter version 3.38.7 on channel stable at /Users/xuehui/Documents/flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 3b62efc2a3 (3 weeks ago), 2026-01-13 13:47:42 -0800
    • Engine revision 78fc3012e4
    • Dart version 3.10.7
    • DevTools version 2.51.1
    • Feature flags: enable-web, enable-linux-desktop, enable-macos-desktop, enable-windows-desktop, enable-android, enable-ios, cli-animations, enable-native-assets, omit-legacy-version-file, enable-lldb-debugging

How to reproduce?

Running the example project, clicking 'compress HEIC' on iOS reports 'file not found'.

Logs

<<<< CMPhotoPixelBufferUtilities >>>> signalled err=-17102 at <>:5398
-[CIContext(ImageRepresentation) _CMPhotoRepresentationOfImage:depth:allowAlpha:containerFormat:colorSpace:options:error:] failed to add image to the PhotoCompressionSession. (kCMPhotoError_InvalidData)

Example code (optional)

Contact

No response

[CaiJingLong]

Investigation result

Conclusion: ❌ Unable to reproduce the reported example flow (5 variants across 2 available iOS runtimes). The exact iPhone 12 mini / iOS 26.2 result remains unverified because I do not have an online iOS 26.2 device or runtime.

There is, however, a real failure path in version 2.4.0 that produces the reported "file not found" symptom, and its color-space variant is reproducible. It is a strong candidate for this report, but the local evidence does not prove that it is what happened on the reporter's iOS 26.2 device.

Environment

• Test date: 2026-07-22
• Host: macOS 14.7.4 arm64
• Xcode 16.2 (iPhoneSimulator SDK 18.2)
• Simulators: iPhone 12 mini, iOS 17.4 and iOS 18.3.1
• Code under test: the native HEIC call and scaling behavior from tag flutter_image_compress-v2.4.0
• Exact example asset: example/img/img.jpg, 4000x2327, SHA-256 50b9949ffc774c96fb40dc0073383905f5023d85b2fec615575e31e0bd430628

Paths tried

1. Exact repository JPEG -> version 2.4.0 scaling (1920x1116) -> kCIFormatARGB8 / ciImage.colorSpace / quality 0.9: valid HEIC produced.
2. Deterministically generated 4000x2327 JPEG through the same version 2.4.0 path on both iOS 17.4 and 18.3.1: valid HEIC produced.
3. Original odd-sized 4000x2327 image without scaling: valid HEIC produced.
4. Alpha-bearing and opaque 1920x1116 bitmap contexts: both produced valid HEIC files.
5. Current UIGraphicsImageRenderer path with standard-range sRGB: valid HEIC produced.

Relevant output from iOS 18.3.1 with the repository asset:

ENV=iOS_18.3.1 model=iPhone
SOURCE=repository_img.jpg
INPUT=source_4000x2327 scaled_1920x1116 scaledAlpha=present scaledColorSpace=kCGColorSpaceDeviceRGB
CASE=v240_exact inputColorSpace=kCGColorSpaceDeviceRGB outputColorSpace=kCGColorSpaceDeviceRGB success=true bytes=309573 brand=heic errorDomain=none errorCode=0 error=none
CASE=odd_4000x2327 inputColorSpace=kCGColorSpaceSRGB outputColorSpace=kCGColorSpaceSRGB success=true bytes=1282725 brand=heic errorDomain=none errorCode=0 error=none
CASE=opaque_1920x1116 inputColorSpace=kCGColorSpaceDeviceRGB outputColorSpace=kCGColorSpaceDeviceRGB success=true bytes=309573 brand=heic errorDomain=none errorCode=0 error=none
CASE=current_renderer inputColorSpace=kCGColorSpaceSRGB outputColorSpace=kCGColorSpaceSRGB success=true bytes=309573 brand=heic errorDomain=none errorCode=0 error=none

Confirmed failure path in 2.4.0

Version 2.4.0 passes ciImage.colorSpace directly to writeHEIFRepresentationOfImage without guarding NULL, ignores the Core Image BOOL/NSError, attempts to read the missing intermediate file, then unconditionally returns targetPath even when data is nil. Consequently, Dart receives an XFile for a path that was never created. This matches the reported user-visible "file not found" behavior after a native HEIC encode failure.

Apple's SDK contract requires an RGB or monochrome color space matching the CIFormat. A controlled CIImage whose color space is NULL fails consistently; applying the sRGB fallback from #358 to the identical pixels succeeds:

iOS=18.3.1 image.colorSpace=NULL
v2.4.0-call colorSpace=NULL success=false bytes=0 error=The operation couldn’t be completed. (CINonLocalizedDescriptionKey error 2.)
PR-358-fallback colorSpace=sRGB success=true bytes=738 error=none

This control does not emit the reporter's exact kCMPhotoError_InvalidData / -17102 log on iOS 18.3.1, so it is evidence of a relevant defect, not proof of the iOS 26.2 trigger.

The self-contained control below requires Xcode with an installed iOS 17+ simulator and jq. Save it as issue-352.sh and run /bin/bash issue-352.sh; it creates its own deterministic 64x64 input and simulator app.

One-command native control reproducer

#!/bin/bash
set -euo pipefail

ROOT=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)/minimal-build
APP="$ROOT/Issue352.app"
BUNDLE_ID=dev.fluttercandies.issue352.minimal
DEVICE_NAME="FIC Issue 352 Minimal"
mkdir -p "$APP"

cat > "$ROOT/main.m" <<'OBJC'
#import <CoreImage/CoreImage.h>
#import <ImageIO/ImageIO.h>
#import <UIKit/UIKit.h>

static void Encode(CIImage *image, CGColorSpaceRef colorSpace, const char *label) {
    NSURL *url = [NSURL fileURLWithPath:[NSTemporaryDirectory()
        stringByAppendingPathComponent:[NSString stringWithFormat:@"%s.heic", label]]];
    [[NSFileManager defaultManager] removeItemAtURL:url error:nil];
    NSError *error = nil;
    BOOL ok = [[[CIContext alloc] init] writeHEIFRepresentationOfImage:image
        toURL:url format:kCIFormatARGB8 colorSpace:colorSpace
        options:@{(__bridge NSString *)kCGImageDestinationLossyCompressionQuality: @0.9}
        error:&error];
    NSData *data = [NSData dataWithContentsOfURL:url];
    printf("%s colorSpace=%s success=%s bytes=%lu error=%s\n", label,
           colorSpace ? "sRGB" : "NULL", ok ? "true" : "false",
           (unsigned long)data.length,
           error ? error.localizedDescription.UTF8String : "none");
    fflush(stdout);
}

@interface AppDelegate : UIResponder <UIApplicationDelegate>
@end

@implementation AppDelegate
- (BOOL)application:(UIApplication *)app didFinishLaunchingWithOptions:(NSDictionary *)options {
    const size_t width = 64, height = 64, rowBytes = width * 4;
    NSMutableData *pixels = [NSMutableData dataWithLength:rowBytes * height];
    memset(pixels.mutableBytes, 0x7f, pixels.length);
    CIImage *image = [CIImage imageWithBitmapData:pixels bytesPerRow:rowBytes
        size:CGSizeMake(width, height) format:kCIFormatRGBA8 colorSpace:NULL];

    printf("iOS=%s image.colorSpace=%s\n",
           UIDevice.currentDevice.systemVersion.UTF8String,
           image.colorSpace ? "non-NULL" : "NULL");
    Encode(image, image.colorSpace, "v2.4.0-call");
    CGColorSpaceRef sRGB = CGColorSpaceCreateWithName(kCGColorSpaceSRGB);
    Encode(image, sRGB, "PR-358-fallback");
    CGColorSpaceRelease(sRGB);
    exit(0);
    return YES;
}
@end

int main(int argc, char **argv) {
    @autoreleasepool {
        return UIApplicationMain(argc, argv, nil, NSStringFromClass(AppDelegate.class));
    }
}
OBJC

cat > "$APP/Info.plist" <<'PLIST'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
<key>CFBundleExecutable</key><string>Issue352</string>
<key>CFBundleIdentifier</key><string>dev.fluttercandies.issue352.minimal</string>
<key>CFBundleName</key><string>Issue352</string>
<key>CFBundlePackageType</key><string>APPL</string>
<key>CFBundleShortVersionString</key><string>1</string>
<key>CFBundleVersion</key><string>1</string>
<key>MinimumOSVersion</key><string>17.0</string>
<key>UIDeviceFamily</key><array><integer>1</integer></array>
<key>UILaunchScreen</key><dict/>
</dict></plist>
PLIST

JQ=$(command -v jq)
RUNTIME=$(xcrun simctl list runtimes -j | "$JQ" -r \
  '[.runtimes[] | select(.platform == "iOS" and .isAvailable)] | sort_by(.version | split(".") | map(tonumber)) | last | .identifier')
DEVICE=$(xcrun simctl list devices available -j | "$JQ" -r \
  --arg runtime "$RUNTIME" --arg name "$DEVICE_NAME" \
  '.devices[$runtime][]? | select(.name == $name) | .udid' | head -n 1)
if [ -z "$DEVICE" ]; then
  DEVICE=$(xcrun simctl create "$DEVICE_NAME" \
    com.apple.CoreSimulator.SimDeviceType.iPhone-12-mini "$RUNTIME")
fi

SDK=$(xcrun --sdk iphonesimulator --show-sdk-path)
xcrun clang -fobjc-arc -fmodules -target "$(uname -m)-apple-ios17.0-simulator" \
  -isysroot "$SDK" "$ROOT/main.m" -o "$APP/Issue352" \
  -framework UIKit -framework CoreImage -framework ImageIO
codesign --force --sign - --timestamp=none "$APP" >/dev/null
xcrun simctl boot "$DEVICE" 2>/dev/null || true
xcrun simctl bootstatus "$DEVICE" -b
xcrun simctl install "$DEVICE" "$APP"
xcrun simctl launch --console-pty --terminate-running-process "$DEVICE" "$BUNDLE_ID"

Relevant changes and requested cross-check

• Fix iOS 17 compatibility #335 (merged 2026-07-12) replaces the deprecated bitmap renderer and produces standard-range sRGB output in this path.
• fix(iOS): guard HEIC encoding against nil colorSpace and silent write failures #358 (merged 2026-07-14) adds the NULL color-space fallback and checks both HEIC encoding and final file-writing failures.
• Both are included in flutter_image_compress_common 1.1.0 and flutter_image_compress 2.5.0 (release tag dated 2026-07-17).

@landfound, could you please rerun the unchanged example on the same iPhone 12 mini / iOS 26.2 after resolving flutter_image_compress 2.5.0 and flutter_image_compress_common 1.1.0? If it still fails, please paste the new HEIC write failed: ... line and the resolved package versions from flutter pub deps. That will distinguish this already-fixed color-space/write path from a separate iOS 26.2 encoder regression.

This comment was generated by AI agent codex (model: GPT-5).