springMVC整合aliPay沙箱支付pc网页快速接入，及踩坑记录

1. 官方文档及下载相关alipay官方demo

1. alipay沙箱环境官方文档地址：https://opendocs.alipay.com/open/200/105311/
2. alipay网页支付开放文档地址：https://opendocs.alipay.com/open/270/105898
3. alipay的demo下载地址：https://opendocs.alipay.com/open/270/106291
4. 第一步：请参照官方文档地址，申请并注册以及配置号沙箱环境！ 步骤：进入开发者中心 -》 研发服务 -》 进行配置（如图所示）

2. 开始接入

2.1. 导入依赖

<!-- 阿里支付 -->
<dependency>
	<groupId>com.alipay.sdk</groupId>
	<artifactId>alipay-sdk-java</artifactId>
	<version>3.7.110.ALL</version>
</dependency>

1. 首先将alipay的demo导入到eclipse中。

2.2. 修改 AlipayConfig.java 并导入到自己的项目中。（AlipayConfig.java见附录）

2.3. 将其jsp的控制改为MVC的控制层AliPayController.java

注：这里一些代码可以从ali的demo下的jsp网页复制！
踩坑记录：这里需要注意，由于使用 springMVC 其中的中文会乱码，alipay的验签也会多出一段！故这里需要采用 response.getWriter().print(); 的方式进行输入！
同时需要注意：要使用 response.getWriter().print(); 那么上边的注解只能是 @Controller 而不可以是@RestController，也不可以加上@ResponseBody！

package com.hx.fresh.controller;

import com.alipay.api.AlipayApiException;
import com.alipay.api.AlipayClient;
import com.alipay.api.DefaultAlipayClient;
import com.alipay.api.internal.util.AlipaySignature;
import com.alipay.api.request.AlipayTradePagePayRequest;
import com.alipay.config.AlipayConfig;
import com.hx.fresh.biz.IOrderInfoBiz;
import com.hx.fresh.entity.OrderInfo;
import com.hx.utils.ParamsUtil;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * 阿里支付控制层
 * @author Huathy
 * @date 2020年4月21日
 */
@Controller
@RequestMapping("/alipay")
public class AliPayController {
	
	@Autowired
	private IOrderInfoBiz orderBiz;
	
	//踩坑记录->这里不可直接return result; 必须要response.getWriter().print(result);或者以map键值对方法返回	
	@RequestMapping("/pay")		
	public String toPay(OrderInfo order,HttpServletRequest request,HttpServletResponse resp,HttpSession session) throws AlipayApiException, IOException {
		if(ParamsUtil.checkNull(order.getOno(),order.getPrice()) ){
			return "<script>alert('支付请求失败！')</script>";
		}
		
		//获得初始化的AlipayClient
		AlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.gatewayUrl, AlipayConfig.app_id, AlipayConfig.merchant_private_key, "json", AlipayConfig.charset, AlipayConfig.alipay_public_key, AlipayConfig.sign_type);
		
		//设置请求参数
		AlipayTradePagePayRequest alipayRequest = new AlipayTradePagePayRequest();
		alipayRequest.setReturnUrl(AlipayConfig.return_url);
		alipayRequest.setNotifyUrl(AlipayConfig.notify_url);
		
		//商户订单号，商户网站订单系统中唯一订单号，必填
		String out_trade_no = String.valueOf(order.getOno());
		session.setAttribute("ono", out_trade_no);
		//付款金额，必填
		String total_amount = String.valueOf(order.getPrice());
		//订单名称，必填
		String subject = "订单名称";
		
		alipayRequest.setBizContent("{\"out_trade_no\":\""+ out_trade_no +"\"," 
				+ "\"total_amount\":\""+ total_amount +"\"," 
				+ "\"subject\":\""+ subject +"\"," 
				+ "\"product_code\":\"FAST_INSTANT_TRADE_PAY\"}");
		String result = alipayClient.pageExecute(alipayRequest).getBody();
		resp.getWriter().print(result);
		return null;
	}
	
	@RequestMapping("callbackNotify")	//服务器异步通知
	public void callbackNotify(HttpServletRequest request,HttpServletResponse resp,HttpSession session) throws IOException, AlipayApiException{
		Map<String,String> params = new HashMap<String,String>();
		Map<String,String[]> requestParams = request.getParameterMap();
		for (Iterator<String> iter = requestParams.keySet().iterator(); iter.hasNext();) {
			String name = (String) iter.next();
			String[] values = (String[]) requestParams.get(name);
			String valueStr = "";
			for (int i = 0; i < values.length; i++) {
				valueStr = (i == values.length - 1) ? valueStr + values[i] : valueStr + values[i] + ",";
			}
			//乱码解决，这段代码在出现乱码时使用
			valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
			params.put(name, valueStr);
		}
		
		PrintWriter out = resp.getWriter();
		
		boolean signVerified = AlipaySignature.rsaCheckV1(params, AlipayConfig.alipay_public_key, AlipayConfig.charset, AlipayConfig.sign_type); //调用SDK验证签名
		if(signVerified) {//验证成功
			//商户订单号
			String out_trade_no = new String(request.getParameter("out_trade_no").getBytes("ISO-8859-1"),"UTF-8");
		
			//支付宝交易号
			String trade_no = new String(request.getParameter("trade_no").getBytes("ISO-8859-1"),"UTF-8");
		
			//交易状态
			String trade_status = new String(request.getParameter("trade_status").getBytes("ISO-8859-1"),"UTF-8");
			
			int result = orderBiz.modifyStatusByOno(Integer.parseInt(out_trade_no), 2);
			
			if(trade_status.equals("TRADE_FINISHED")){
				//判断该笔订单是否在商户网站中已经做过处理
				//如果没有做过处理，根据订单号（out_trade_no）在商户网站的订单系统中查到该笔订单的详细，并执行商户的业务程序
				//如果有做过处理，不执行商户的业务程序
				orderBiz.modifyStatusByOno(Integer.parseInt(out_trade_no), 2);
				out.print("<script>location.href='order.html'</script>");
				//注意：
				//退款日期超过可退款期限后（如三个月可退款），支付宝系统发送该交易状态通知
			}else if (trade_status.equals("TRADE_SUCCESS")){
				//判断该笔订单是否在商户网站中已经做过处理
				//如果没有做过处理，根据订单号（out_trade_no）在商户网站的订单系统中查到该笔订单的详细，并执行商户的业务程序
				//如果有做过处理，不执行商户的业务程序
				orderBiz.modifyStatusByOno(Integer.parseInt(out_trade_no), 2);
				out.print("<script>location.href='order.html'</script>");
				//注意：
				//付款完成后，支付宝系统发送该交易状态通知
			}
			
		}else {//验证失败
			Integer ono = (Integer) session.getAttribute("ono");
			orderBiz.modifyStatusByOno(ono, 1);
			//调试用，写文本函数记录程序运行情况是否正常
			//String sWord = AlipaySignature.getSignCheckContentV1(params);
			//AlipayConfig.logResult(sWord);
		}
	}
	
	@RequestMapping("callbackReturn")	//页面跳转同步通知
	public void callbackReturn(HttpServletRequest request,HttpServletResponse resp) throws AlipayApiException, IOException{
		Map<String,String> params = new HashMap<String,String>();
		Map<String,String[]> requestParams = request.getParameterMap();
		for (Iterator<String> iter = requestParams.keySet().iterator(); iter.hasNext();) {
			String name = (String) iter.next();
			String[] values = (String[]) requestParams.get(name);
			String valueStr = "";
			for (int i = 0; i < values.length; i++) {
				valueStr = (i == values.length - 1) ? valueStr + values[i]
						: valueStr + values[i] + ",";
			}
			//乱码解决，这段代码在出现乱码时使用
			valueStr = new String(valueStr.getBytes("ISO-8859-1"), "utf-8");
			params.put(name, valueStr);
		}
		
		PrintWriter out = resp.getWriter();
		boolean signVerified = AlipaySignature.rsaCheckV1(params, AlipayConfig.alipay_public_key, AlipayConfig.charset, AlipayConfig.sign_type); //调用SDK验证签名

		//——请在这里编写您的程序（以下代码仅作参考）——
		if(signVerified) {
			//商户订单号
			String out_trade_no = new String(request.getParameter("out_trade_no").getBytes("ISO-8859-1"),"UTF-8");
		
			//支付宝交易号
			String trade_no = new String(request.getParameter("trade_no").getBytes("ISO-8859-1"),"UTF-8");
		
			//付款金额
			String total_amount = new String(request.getParameter("total_amount").getBytes("ISO-8859-1"),"UTF-8");
			int result = orderBiz.modifyStatusByOno(Integer.parseInt(out_trade_no), 2);
			out.print("<script>location.href='../order.html'</script>");
		}else {
			out.println("验签失败");
		}
	}
}

2.4. 前端js请求

$.post("alipay/pay",{ono:ono,price:totalPrice},function(data){
	$("#alipay").html(data)
});

附录：

1. AlipayConfig.java

注意：通知路径需要外网可以访问才可，可以通过内网穿透，或架设到公网的服务器上！

package com.alipay.config;

import java.io.FileWriter;
import java.io.IOException;

/* *
 *类名：AlipayConfig
 *功能：基础配置类
 *详细：设置帐户有关信息及返回路径
 *修改日期：2017-04-05
 *说明：
 *以下代码只是为了方便商户测试而提供的样例代码，商户可以根据自己网站的需要，按照技术文档编写,并非一定要使用该代码。
 *该代码仅供学习和研究支付宝接口使用，只是提供一个参考。
 */

public class AlipayConfig {

	// ↓↓↓↓↓↓↓↓↓↓请在这里配置您的基本信息↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

	// 应用ID,您的APPID，收款账号既是您的APPID对应支付宝账号
	public static String app_id = "xxx";

	// 商户私钥，您的PKCS8格式RSA2私钥
	public static String merchant_private_key = "xxx";

	// 支付宝公钥,查看地址：https://openhome.alipay.com/platform/keyManage.htm
	// 对应APPID下的支付宝公钥。
	public static String alipay_public_key = "xxxx";
 
	// 服务器异步通知页面路径 需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问
	public static String notify_url = "http://xxx.free.idcfengye.com/项目名/alipay/callbackNotify";

	// 页面跳转同步通知页面路径 需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问
	public static String return_url = "http://xxx.free.idcfengye.com/项目名/alipay/callbackReturn";

	// 签名方式
	public static String sign_type = "RSA2";

	// 字符编码格式
	public static String charset = "utf-8";

	// 支付宝网关
	public static String gatewayUrl = "https://openapi.alipaydev.com/gateway.do";

	// 支付宝网关
	public static String log_path = "C:\\";

	// ↑↑↑↑↑↑↑↑↑↑请在这里配置您的基本信息↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑

	/**
	 * 写日志，方便测试（看网站需求，也可以改成把记录存入数据库）
	 * @param sWord  要写入日志里的文本内容
	 */
	public static void logResult(String sWord) {
		FileWriter writer = null;
		try {
			writer = new FileWriter(log_path + "alipay_log_" + System.currentTimeMillis() + ".txt");
			writer.write(sWord);
		} catch (Exception e) {
			e.printStackTrace();
		} finally {
			if (writer != null) {
				try {
					writer.close();
				} catch (IOException e) {
					e.printStackTrace();
				}
			}
		}
	}
}

本文为个人学习笔记，若有错误还请指正！转载请附上本文链接！