问题描述
部署在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-