【Azure 应用服务】App Service for Linux环境中，如何解决字体文件缺失的情况

问题描述

部署在App Service for Linux环境中的Web App。出现了字体文件缺失的问题，页面显示本来时中文的地方，区别变为方框占位。

问题分析

在应用中，通常涉及到显示问题的有两个方面，

一是乱码：”����Ҫ�¨²�ѧϰ������“ ， ”由月è¦�å¥½å¥½å­¦ä¹ å¤å¤å�‘上“ ，”鐢辨湀瑕佸ソ濂藉涔犲ぉ澶╁悜涓?“ ”锟斤拷锟斤拷要锟“  , 这些内容表示的问题就是编码问题。

二是字体缺失：表现形式为用“□”方框来作为占位符。

对于第一个问题，我们可以通过应用配置来修改字符编码问题（可以参考文章：https://www.cnblogs.com/lulight/p/13531483.html）。而字体缺失，则可以通过下面的方式来验证。

第一步：通过App Service Kudu站点的SSH进入Linux，查看是否已经安装了TTF-DEJAVU文件 cd /usr/share/fonts/ttf-dejavu/

第二步：如果没有ttf-dejavu文件，就需要通过 apk --no-cache add ttf-dejavu 安装，然后使用cp命令把缺少的TTF文件复制到 /usr/share/fonts/ttf-dejavu/ 目录下

apk --no-cache add ttf-dejavu
cp /home/site/SIMHEI.TTF /usr/share/fonts/ttf-dejavu/SIMHEI.TTF

##PS: 比如SIMHEI.TTF文件已经保存在 home/site文件中

问题解决

在App Service for Linux中，可以通过启动脚本方式(Stratup Script)来初始化字体文件。详细步骤为：

1） 新建一个startup_script.sh 文件，内容为：

apk --no-cache add ttf-dejavu

cp /home/site/SIMHEI.TTF /usr/share/fonts/ttf-dejavu/SIMHEI.TTF

注：需要把SIMHEI.TTF 文件上传到app service 的  home/site/目录中。

2）把文件放置在home/site目录下，如：/home/site/deployments/tools/startup_script.sh，可以通过FTP方式上传文件，或者直接包含在应用的项目文件中，路径可以自定义，只要在/Home/下就可以。

3）把第一步中脚本所在的路径，设置在启动路径中。重启站点即可解决问题。

修改完成后，正确的显示：

附录一：如果单独进入App Service SSH, 安装字体后，当实例发生重启，切换等都会导致之前的安装失效，所以如果要永久解决字体问题，还是需要在启动脚本中安装字体文件。

安装字体文件的脚本为：

#! /usr/bin/bash
cd /home/site/wwwroot/
if [ -f fonts.tar.gz ]; then
  echo '=============================================='
  echo 'install fonts......'
  echo '=============================================='
  tar -zxf fonts.tar.gz
  cp fonts/* /usr/share/fonts
  cd /usr/share/fonts/
  mkfontscale && mkfontdir && fc-cache
  cd /home/site/wwwroot/
fi

参考资料

配置Java应用（第六步）：https://docs.azure.cn/zh-cn/app-service/configure-language-java?pivots=platform-linux#finalize-configuration-1

What are the expected values for the Startup File section when I configure the runtime stack? https://docs.microsoft.com/en-us/troubleshoot/azure/general/faqs-app-service-linux#what-are-the-expected-values-for-the-startup-file-section-when-i-configure-the-runtime-stack-