📖Flask实战的经验总结📖
📱有问题随时与我联系，一起学习交流📱
❤️喜欢的话点个三连吧❤️

1.前言

本人最近用flask开发一个web项目，要部署到单位内网中，内网服务器是window server 2016，本文讲了部署的基本流程和一些爬坑过程。

环境：Windows server 2016 + Python 3.6.6 + Apache2.4

2.简单理解Flask框架，web服务器（Apache）和WSGI的关系

Web框架层。Web框架的作用主要是方便我们开发 web应用程序，HTTP请求的动态数据就是由 web框架层来提供的。比如：Django、Flask等。我选用Python的轻量级web开发框架Flask进行项目开发，Flask提供了轻量级的Web服务，方便进行开发和调试，但是在实际部署的时候，却不能直接用Flask发布应用，这在我们开发过程中有提示:WARNING:This is a development server. Do not use it in a production deployment. falsk WSGI，因此还需要Web服务和WSGI（web服务网关接口）。

web服务器层。Web服务器的主要作用就是接收请求 、处理请求、返回响应。比如：Nginx，Apache，IIS等。本次选用的是Apache。

WSGI层。WSGI不是服务器，也不是用于与程序交互的API，只是一种接口，它只适用于 Python 语言，其全称为 Web Server Gateway Interface，定义了 web服务器和 web应用之间的接口规范。也就是说，只要 web服务器和 web应用都遵守WSGI协议，那么 web服务器和 web应用就可以随意的组合。

3.准备一些安装包

1. Python
2. Apache
3. mod_wsgi
4. flask项目的依赖包

• ⚠️三个软件的版本一定要匹配

3.1下载Python

本次下载的Python 3.6.6 64位。下载链接

3.2下载Apache

本次下载的Apache 2.4。下载链接

版本选择一定要注意，首先我们打开Python终端，可以看到如下信息（我写文章的电脑是3.6.1版本，实际要参照安装部署环境的Python版本）：

Python 3.6.1 (v3.6.1:69c0db5, Mar 21 2017, 18:41:36) [MSC v.1900 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.

找到[MSC v.1900 64 bit (AMD64)]

对照下表，可知 MSC_VER=1900 对应 Visual C++ 2015 (14.0)：

Visual C++ 2005  (8.0)          MSC_VER=1400
Visual C++ 2008  (9.0)          MSC_VER=1500
Visual C++ 2010 (10.0)          MSC_VER=1600
Visual C++ 2012 (11.0)          MSC_VER=1700
Visual C++ 2013 (12.0)          MSC_VER=1800
Visual C++ 2015 (14.0)          MSC_VER=1900
Visual C++ 2017 (15.0)          MSC_VER=1910

在Apache下载链接中找到VC2015、64位的版本下载。

3.3下载mod_wsgi

进入下载页面

选择cp36对应Python3.6版本，amd64对应64位操作系统。

3.4准备Flask项目离线安装包

由于内网与互联网不通，因此需要提前准备好Flask项目离线安装包。
具体步骤参照Python虚拟环境中的依赖包迁移到断网环境。
安装文章步骤操作后，这里我们将所有的依赖包会存放在whls文件夹，并形成一个requirement.txt文档。

4.进行安装

将上述安装包httpd-2.4.53-o111n-x64-vc15.zip、python3.6.6.rar、mod_wsgi-4.7.1-cp36-cp36m-win_amd64.whl，whls文件夹和requirement.txt拷贝到内网环境中进行安装。

4.1安装Python

这里不详细介绍，参照Windows下Python3的环境搭建。

4.2安装Apache

1. 将httpd-2.4.53-o111n-x64-vc15.zip解压到任意位置，这里我解压到D盘。
2. 使用命令行界面（以管理员身份运行）进入到对应目录。

>CD D:\Apache24\bin

3. 将Apache服务加入到Windows服务中，并尝试启动测试，报错，这是因为监听端口被占用。

D:\Apache24\bin>httpd -k install -n "Apache2.4"
Installing the 'Apache2.4' service
The 'Apache2.4' service is successfully installed.
Testing httpd.conf....
Errors reported here must be corrected before the service can be started.
(OS 10013)以一种访问权限不允许的方式做了一个访问套接字的尝试。  : AH00072: make_sock: could not bind to address [::]:80
(OS 10013)以一种访问权限不允许的方式做了一个访问套接字的尝试。  : AH00072: make_sock: could not bind to address 0.0.0.0:80
AH00451: no listening sockets available, shutting down
AH00015: Unable to open logs

我们进入到D:\Apache24\conf，打开httpd.conf文件，找到如下信息：

#Listen 12.34.56.78:80
Listen 80

将监听端口80端口修改，如8080。

通过运行栏，输入services.msc进入服务管理窗口，启动刚才安装的Apache2.4服务，进入浏览器，输入http://127.0.0.1:8063/，如果显示如下页面，说明服务启动成功。

4.3安装flask项目依赖包，并测试flask项目

参照Python虚拟环境中的依赖包迁移到断网环境，与这篇教程不同的是，在内网环境中，我并没有使用虚拟环境，直接将相关依赖包安装到了全局环境下。

此时可以测试下项目在flask提供的web服务下是否能正常运行（note：虚拟环境部署项目还是有些小问题，日后解决了再分享，以实际需求为主，内网环境只部署一个项目，所以不需要虚拟环境也可以。）

4.4安装mod_wsgi

使用命令行界面（以管理员身份运行）进入到mod_wsgi-4.7.1-cp36-cp36m-win_amd64.whl对应目录，直接安装。

>pip install mod_wsgi-4.7.1-cp36-cp36m-win_amd64.whl
Installing collected packages: mod-wsgi
Successfully installed mod-wsgi-4.7.1

安装成功后，切换到python的安装目录的\scripts文件夹下运行如下命令：

c:\Python36\Scripts>mod_wsgi-express module-config
LoadFile "c:/users/***/anaconda3/python36.dll"
LoadModule wsgi_module "c:/users/***/anaconda3/lib/site-packages/mod_wsgi/server/mod_wsgi.cp36-win_amd64.pyd"
WSGIPythonHome "c:/users/chengyikang/anaconda3"

保存上述3行信息用于下步配置。

5.配置

到了最后一步配置了，坚持住！

5.1wsgi文件配置

进入到项目根目录，新建app.wsgi文件，进行如下设置：

import sys
sys.path.insert(0,"C:\Users\***\PycharmProjects\bulletin_board")
from bulletin_board import app as application

5.2httpd.conf文件配置

再次进入到D:\Apache24\conf，打开httpd.conf文件，进行配置修改。

1. 找到Define SRVROOT "/Apache24" 修改成自己的安装路径，如”D:/Apache24″
2. 将上面4.4节中的3行信息复制到最下方。

LoadFile "c:/users/***/anaconda3/python36.dll"
LoadModule wsgi_module "c:/users/***/anaconda3/lib/site-packages/mod_wsgi/server/mod_wsgi.cp36-win_amd64.pyd"
WSGIPythonHome "c:/users/chengyikang/anaconda3"

3. 再添加如下内容，C:\Users\***\PycharmProjects\bulletin_board是我的项目所在目录，大家根据自己的项目进行调整：

WSGIPythonPath "C:\Users\***\PycharmProjects\bulletin_board"

<VirtualHost *:8063>
	ServerName example.com
	WSGIScriptAlias / C:\Users\***\PycharmProjects\bulletin_board\app.wsgi
	
	<Directory C:\Users\***\PycharmProjects\bulletin_board>
		Require all granted
	</Directory>
</VirtualHost>

这块的知识我没有掌握，没法给大家讲清每一行的意义，可以参考官方文档和官方文档2进行学习。

5.3尝试运行

运行服务的方式有多种：

1. 进入C:\Apache24\bin目录，打开ApacheMonitor.exe，进行可视化操作：start,stop,restart。
   
2. 在C:\Apache24\bin目录下CMD打开命令行，输入httpd -k start，停止服务器就输入httpd -k stop，重启服务器输入httpd -k restart。
3. 通过运行栏，输入services.msc进入服务管理窗口，启动/停止/重启刚才安装的Apache2.4服务。

6.一些问题

6.1 输入localhost:8063响应码500

有时候会访问服务器，浏览器会提示：500 Internal Server Error，我们进入C:\Apache24\logs打开error.log错误日志分析原因，看不懂的百度下一般都可以解决。

[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] mod_wsgi (pid=14068): Failed to exec Python script file 'C:/Users/Chengyikang/PycharmProjects/bulletin_board/app.wsgi'.
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] mod_wsgi (pid=14068): Exception occurred processing WSGI script 'C:/Users/Chengyikang/PycharmProjects/bulletin_board/app.wsgi'.
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933]   File "C:/Users/Chengyikang/PycharmProjects/bulletin_board/app.wsgi", line 2\r
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933]     sys.path.insert(0,"C:\\Users\\Chengyikang\\PycharmProjects\\bulletin_board")\r
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933]                      ^\r
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: truncated \\UXXXXXXXX escape\r

我的报错是因为路径中\转义符的问题，在字符串前面加上r。
restart重启，查看问题是否修复。

6.2 RuntimeError: cryptography is required错误

如果项目中有“输入密码”选项，并用到了数据库保存密码，可能会报“RuntimeError: cryptography is required for sha256_password or caching_sha2_password”这个错误，这时候直接pip install cryptography 安装这个模块就可以了。

如果是离线安装，参照Python虚拟环境中的依赖包迁移到断网环境，但要注意安装的顺序：

pip install pycparser-2.21-py2.py3-none-any.whl
pip install cffi-1.15.0-cp36-cp36m-win_amd64.whl
pip install cryptography-36.0.2-cp36-abi3-win_amd64.whl

在安装cryptography-36.0.2-cp36-abi3-win_amd64.whl时，会报错，因为文件名不支持，将abi3改为none即可。
原因分析参考Python使用pip安装报错：is not a supported wheel on this platform的解决方法。