Flask与NextJS改写工具部署后POST路由/api/paraphrase出现404问题求助

问题原因 #

你把Flask应用代码放在了NextJS的api目录下，但NextJS的api目录仅支持Node.js编写的API路由，Netlify部署时不会识别并运行其中的Python Flask应用，导致访问该路径返回404。

解决方案：改用Netlify Functions部署Python后端逻辑 #

Netlify Functions支持运行Python函数，你需要把Flask的业务逻辑转换成Netlify Function的格式，具体步骤如下：

1. 调整项目结构 #

在项目根目录创建netlify/functions文件夹，将原Flask逻辑迁移到该目录下的新文件中，比如命名为paraphrase.py：

from paraphraser import paraphrase
import json
import sys
import os

# 确保paraphraser模块能被找到（如果paraphraser.py在项目根目录）
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

def handler(event, context):
    # 处理跨域预检请求
    if event['httpMethod'] == 'OPTIONS':
        return {
            'statusCode': 200,
            'headers': {
                'Access-Control-Allow-Origin': '*',
                'Access-Control-Allow-Methods': 'POST, OPTIONS',
                'Access-Control-Allow-Headers': 'Content-Type'
            }
        }
    
    # 处理POST请求
    if event['httpMethod'] == 'POST':
        try:
            data = json.loads(event['body'])
            question = data['question']
            paraphrased_result = paraphrase(question)
            
            return {
                'statusCode': 200,
                'headers': {
                    'Content-Type': 'application/json',
                    'Access-Control-Allow-Origin': '*'
                },
                'body': json.dumps({'result': paraphrased_result})
            }
        except KeyError:
            return {
                'statusCode': 400,
                'headers': {
                    'Content-Type': 'application/json',
                    'Access-Control-Allow-Origin': '*'
                },
                'body': json.dumps({'error': '缺少必填字段question'})
            }
        except Exception as e:
            return {
                'statusCode': 500,
                'headers': {
                    'Content-Type': 'application/json',
                    'Access-Control-Allow-Origin': '*'
                },
                'body': json.dumps({'error': str(e)})
            }
    else:
        return {
            'statusCode': 405,
            'headers': {
                'Content-Type': 'application/json',
                'Access-Control-Allow-Origin': '*'
            },
            'body': json.dumps({'error': '仅支持POST请求'})
        }

2. 配置依赖 #

在项目根目录创建requirements.txt，列出所有需要的Python依赖：

# 根据paraphraser的实际需求添加依赖，比如transformers、torch等
flask-cors
# 其他必要依赖

3. 修改前端请求地址 #

原来的前端请求地址/api/paraphrase需要改为Netlify Function的访问路径/.netlify/functions/paraphrase。

4. 本地测试与部署 #

• 安装Netlify CLI：npm install -g netlify-cli
• 本地运行测试：netlify dev，此时可通过http://localhost:8888/.netlify/functions/paraphrase测试API
• 部署到Netlify：推送代码到关联的Git仓库，Netlify会自动构建并部署Functions

额外说明 #

如果你的paraphraser.py依赖较大的机器学习模型，需要注意Netlify Functions的资源限制（部署包大小、运行内存、超时时间等）。若遇到部署失败或运行异常，可考虑：

• 优化模型体积（比如使用量化模型）
• 将后端单独部署到更适合运行模型的平台（如Render、AWS Lambda），前端通过API调用外部服务

内容的提问来源于stack exchange，提问作者Suha Karkhy