.NET Core 圖片操作在 Linux/Docker 下的坑

一.前言

.NET Core 目前更新到2.2了，但是直到現在在 .NET Core 本身依然不包括和圖片有關的 Image、Bitmap 等類型。對於圖片的操作在我們開發中很常見，比如：生成驗證碼、二維碼等等。在 .NET Core 的早期版本中，有 .NET 社區開發者實現了一些 System.Drawing 的 Image等類型實現的組件，比如 CoreCompat.System.Drawing、ZKWeb.System.Drawing等。后來微軟官方提供了一個組件 System.Drawing.Common實現了 System.Drawing 的常用類型，以 Nuget 包的方式發布的。今天就圍繞它來講一講這里面的坑。

在 .NET Core 中可以通過安裝 System.Drawing.Common 來使用 Image、Bitmap 等類型。

二.尋坑

本文將以一個 ASP.NET Core 項目使用 QRCoder 組件來生成一個二維碼作為示例。

1.新建一個 ASP.NET Core 項目

2.安裝 QRCoder

dotnet add package QRCoder

QRCoder是一個非常強大的生成二維碼的組件，它使用了 System.Drawing.Common ，所以安裝它用來做測試。

3.打開 ValuesController，添加如下代碼：

1.  
   [ Route("api/[controller]")]
2.  
   [ ApiController]
3.  
   public class ValuesController : ControllerBase
4.  
   {
5.  
   [ HttpGet]
6.  
   public FileResult Get()
7.  
   {
8.  
   QRCodeGenerator.ECCLevel eccLevel = QRCodeGenerator.ECCLevel.L;
9.  
   using (QRCodeGenerator qrGenerator = new QRCodeGenerator())
10.  
    {
11.  
    using (QRCodeData qrCodeData = qrGenerator.CreateQrCode("Hello .NET Core", eccLevel))
12.  
    {
13.  
    using (QRCode qrCode = new QRCode(qrCodeData))
14.  
    {
15.  
    Bitmap bp = qrCode.GetGraphic( 20, Color.Black, Color.White,true);
16.  
    return File(Bitmap2Byte(bp), "image/png", "hello-dotnetcore.png");
17.  
    }
18.  
    }
19.  
    }
20.  
    }
21.  
     
22.  
    public static byte[] Bitmap2Byte(Bitmap bitmap)
23.  
    {
24.  
    using (MemoryStream stream = new MemoryStream())
25.  
    {
26.  
    bitmap.Save(stream, ImageFormat.Jpeg);
27.  
    byte[] data = new byte[stream.Length];
28.  
    stream.Seek( 0, SeekOrigin.Begin);
29.  
    stream.Read(data, 0, Convert.ToInt32(stream.Length));
30.  
    return data;
31.  
    }
32.  
    }

上面的代碼生成了一個二維碼，通過API返回，文件名為 hello-dotnetcore.png

4.運行

（1）Windows

在 Windows 環境下我們直接運行，打開瀏覽器訪問 http://localhost:5000/api/values

查看該圖片：

一切正常

（2）Linux 或者 Docker(Linux)

Docker(Linux)指：以Linux系統為基礎的鏡像

我們將代碼原封不動的拷貝到 Linux 上運行

使用curl訪問

curl http://localhost:5000/api/values

查看日志輸出可以見到報錯了

1.  
   fail: Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware[ 1]
2.  
   An unhandled exception has occurred while executing the request.
3.  
   System.TypeInitializationException: The type initializer for 'Gdip' threw an exception. ---> System.DllNotFoundException: Unable to load DLL 'libgdiplus': The specified module could not be found.

該異常的意思是： 找不到DLL libgdiplus，如何解決？請看下一小節。

三.埋坑

System.Drawing.Common 組件提供對GDI+圖形功能的訪問。它是依賴於GDI+的，那么在Linux上它如何使用GDI+，因為Linux上是沒有GDI+的。Mono 團隊使用C語言實現了GDI+接口，提供對非Windows系統的GDI+接口訪問能力（個人認為是模擬GDI+，與系統圖像接口對接），這個就是 libgdiplus。進而可以推測 System.Drawing.Common 這個組件實現時，對於非Windows系統肯定依賴了 ligdiplus 這個組件。如果我們當前系統不存在這個組件，那么自然會報錯，找不到它，安裝它即可解決。

libgdiplus github: https://github.com/mono/libgdiplus

1.CentOS

1.  
   #一鍵命令
2.  
   sudo curl https://raw.githubusercontent.com/stulzq/awesome-dotnetcore-image/master/install/centos7.sh|sh

或者

1.  
   yum update
2.  
   yum install libgdiplus-devel -y
3.  
   ln -s /usr/lib64/libgdiplus.so /usr/lib/gdiplus.dll
4.  
   ln -s /usr/lib64/libgdiplus.so /usr/lib64/gdiplus.dll

2.Ubuntu

1.  
   #一鍵命令
2.  
   sudo curl https://raw.githubusercontent.com/stulzq/awesome-dotnetcore-image/master/install/ubuntu.sh|sh

或者

1.  
   apt- get update
2.  
   apt- get install libgdiplus -y
3.  
   ln -s /usr/ lib/libgdiplus.so /usr/lib/gdiplus.dll

3.Docker

Dockerfile 加入 RUN 命令，以官方 asp.net core runtime 鏡像，以 asp.net core 2.2 作為示例：

1.  
   FROM microsoft/dotnet:2.2.0-aspnetcore-runtime
2.  
   WORKDIR /app
3.  
   COPY . .
4.  
   RUN apt -get update -y && apt-get install -y libgdiplus && apt-get clean && ln -s /usr/lib/libgdiplus.so /usr/lib/gdiplus.dll
5.  
   EXPOSE 80
6.  
   ENTRYPOINT ["dotnet", "<你的入口程序集>"]

apt-get update 這一步是必不可少的，不然會報找不到 libgdiplus。但是官方鏡像里面使用的軟件包源又是國外的地址，所以造成我們使用國內網絡非常慢，進而造成整體構建過程非常慢。下面有兩個解決方案：

（1）直接使用打包好的Docker鏡像

該鏡像是基於微軟官方鏡像打包的，只安裝了 libgdiplus，不添加任何添加劑。

將 Dockerfile 中的 FROM microsoft/dotnet:2.2.0-aspnetcore-runtime 換為 FROM stulzq/dotnet:2.2.0-aspnetcore-runtime-with-image

示例：

1.  
   FROM stulzq/dotnet:2.2.0-aspnetcore-runtime-with-image
2.  
   WORKDIR /app
3.  
   COPY . .
4.  
   EXPOSE 80
5.  
   ENTRYPOINT ["dotnet", "<你的入口程序集>"]

（2）更換軟件包源為國內源

此方法請看我以前寫的文章：Docker實用技巧之更改軟件包源提升構建速度

4.其他Linux發行版

首先查詢下是否有編譯好的 libgdiplus，如果沒有可以到官方github查看教程，使用源碼編譯。

四.其他

這里要說明一下在 .NET Core 下，並非所有與圖片操作有關的都需要安裝 libgdiplus，只有你使用的組件依賴於 它提供的GDI+能力（依賴於它）才有必要裝它。就比如你要是用 Image、Bitmap 類型，你就得安裝 System.Drawing.Common ；或者你用的組件依賴了 System.Drawing.Common，比如 QRCoder。

有一些可以用於 .NET Core 的圖片處理組件，自身沒有依賴於 System.Drawing.Common，也沒有依賴於 GDI+，使用它們是無需注意libgdiplus 這個問題的，比如 ImageSharp ，它使用純C#實現了一些圖片底層操作。

SkiaSharp 同樣是可以進行圖片操作的組件，在Linux上需要安裝libSkiaSharp，SkiaSharp是由mono項目組提供的。我沒有深入研究這個庫，有興趣的同學可以研究一下。

命令失效問題

有些同學可能遇到使用了命令無效的問題，據我猜測可能是包源或者是你本身環境導致安裝失敗，目前給出的解決辦法有兩個，一個是clone github源碼編譯安裝，一個是下載離線包安裝：https://pkgs.org/download/libgdiplus

五.結束

本文所訴問題，其實是個老問題了，網上也都有解決方案，本文是擱置很久（一直處於未編輯完狀態）才發布的，這里就算做個總結吧。

本文所用測試代碼、shell命令、以及 Dockerfile 都在github: https://github.com/stulzq/dotnetcore-image 如果覺得有用歡迎 Star