iOS UIImageView 不顯示圖片排查指南：從 URL 加載與本地加載失效原因

常見失效原因清單

代碼問題分析

// 原代碼問題點：
NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:ImageURL]];
// 1. 同步阻塞主線程 (嚴禁)
// 2. 無錯誤處理 (imageData 可能為 nil)
// 3. 無佔位圖/失敗圖
pictureImageView.image = [UIImage imageWithData:imageData];

// 本地加載
pictureImageView.image = [UIImage imageNamed:@"starblue.png"];
// 1. 圖片名稱區分大小寫 (真機)
// 2. 未加入 Copy Bundle Resources

正確異步加載模式 (原生)

- (void)loadImageFromURL:(NSString *)urlString placeholder:(UIImage *)placeholder {
    // 1. 設置佔位圖
    self.pictureImageView.image = placeholder;
    
    // 2. 異步下載
    NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithURL:[NSURL URLWithString:urlString] 
        completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        if (error || !data) {
            NSLog(@"下載失敗: %@", error);
            return;
        }
        UIImage *image = [UIImage imageWithData:data];
        if (!image) {
            NSLog(@"數據解碼失敗");
            return;
        }
        // 3. 主線程更新 UI
        dispatch_async(dispatch_get_main_queue(), ^{
            // 防止 Cell 復用導致圖片錯位 (可選: 記錄 url 比對)
            self.pictureImageView.image = image;
        });
    }];
    [task resume];
}

強烈建議：使用成熟圖片加載庫

SDWebImage 一行代碼

#import 

[self.pictureImageView sd_setImageWithURL:[NSURL URLWithString:urlString] 
                          placeholderImage:[UIImage imageNamed:@"placeholder"] 
                                 options:SDWebImageRetryFailed 
                            progress:nil 
                           completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
    if (error) NSLog(@"加載失敗: %@", error);
}];

關鍵檢查：ImageView 可見性與層級

原答案提到的關鍵點：

[self.view bringSubviewToFront:self.pictureImageView];

確保 ImageView 不被其他透明/半透明 View 遮蓋。調試時可在 View Debugger (Xcode -> Debug View Hierarchy) 中檢查層級關係。

Info.plist ATS 配置 (HTTPS 強制)

NSAppTransportSecurity

    NSAllowsArbitraryLoads
      <-- 允許 HTTP (不推薦生產)
    
    NSExceptionDomains
    
        yourdomain.com
        
            NSExceptionAllowsInsecureHTTPLoads
            
        
    

總結排查順序

1. **URL/圖片名稱正確性** (打印日誌驗證)。
2. **主線程同步阻塞** → 改異步或用庫。
3. **ImageView 狀態** : hidden=NO, alpha=1, frame 非零, bringSubviewToFront。
4. **圖片資源** : Target Membership, Asset Catalog, 大小寫 (真機)。
5. **網絡權限** : ATS, HTTPS, 防火牆。
6. **接入 SDWebImage/Kingfisher** 徹底解決緩存、佔位、錯誤、性能全鏈路問題。

手寫異步加載僅適合學習，**生產項目請直接接入成熟庫**，避免重複造輪子並引入難以排查的 Bug。