如何在Django easy_pdf中添加可点击超链接？

我之前也碰到过一模一样的问题！easy_pdf底层依赖的xhtml2pdf对HTML链接的解析有一些特殊要求，默认情况下可能不会把<a>标签转换成PDF里的可点击链接，下面是几个可行的解决方案：

1. 确保链接是绝对URL #

首先检查你的campaign_url是否是完整的绝对URL（比如https://example.com/campaign/123/），而不是相对路径（比如/campaign/123/）。PDF文件本身没有"相对路径"的概念，只有绝对URL才能被识别为可点击的链接。

你可以在视图里把相对URL转换成绝对URL，比如：

from django.contrib.sites.shortcuts import get_current_site

def your_view(request):
    # 其他逻辑...
    current_site = get_current_site(request)
    # 假设item.campaign_url是相对路径，转换为绝对URL
    campaign_url = request.build_absolute_uri(item.campaign_url)
    context = {
        'campaign_url': campaign_url,
        # 其他上下文变量...
    }
    return render_to_pdf_response(request, template_name, context)

2. 调整模板中的链接格式 #

如果绝对URL还是不行，尝试给<a>标签添加target="_blank"属性，或者确保标签写法符合XHTML规范（比如闭合标签），xhtml2pdf对这类标准格式的支持更稳定：

<a href="{{ campaign_url }}" target="_blank">{{ item.campaign_name }}</a>

3. 自定义PDF渲染器（进阶方案） #

如果上面的方法都无效，你可以自定义easy_pdf的渲染器，手动配置xhtml2pdf的链接解析规则：

from easy_pdf.rendering import PDFRenderer
from xhtml2pdf import pisa

class CustomPDFRenderer(PDFRenderer):
    def render(self, request, template, context):
        # 获取基础渲染后的HTML内容
        html_content = super().render(request, template, context)
        # 配置pisa的链接解析回调
        def link_callback(uri, rel):
            return uri  # 直接返回原始URL，确保被识别为可点击链接
        
        # 重新生成PDF文档
        result = BytesIO()
        pisa.CreatePDF(html_content, dest=result, link_callback=link_callback)
        result.seek(0)
        return result

# 在视图中使用自定义渲染器
return render_to_pdf_response(request, template_name, context, renderer_class=CustomPDFRenderer)

一般来说，前两种方法就能解决问题，先从检查绝对URL开始试起，这是最常见的原因！

内容的提问来源于stack exchange，提问作者Zaraki Kenpachi