]*><\/div>/i', function ($matches) use ($parser) { $markdown = html_entity_decode(trim($matches[1]), ENT_QUOTES, 'UTF-8'); $rendered = $parser->transform($markdown); return ''; }, $html ); } /** * 【新增】渲染试卷HTML（通过HTTP调用路由） */ private function renderExamHtml(string $paperId, bool $includeAnswer, bool $useGradingView): ?string { // 判卷部分启用答案详情页时，优先本地渲染，避免跨进程配置不一致。 if ($useGradingView && config('exam.pdf_grading_append_scan_sheet', false)) { return $this->renderExamHtmlFromView($paperId, $includeAnswer, $useGradingView); } try { // 通过HTTP客户端获取渲染后的HTML（与知识点讲解相同的逻辑） $routeName = $useGradingView ? 'filament.admin.auth.intelligent-exam.grading' : 'filament.admin.auth.intelligent-exam.pdf'; $url = route($routeName, ['paper_id' => $paperId, 'answer' => $includeAnswer ? 'true' : 'false']); $response = Http::get($url); if ($response->successful()) { $html = $response->body(); if (! empty(trim($html))) { return $this->ensureUtf8Html($html); } } Log::warning('ExamPdfExportService: 通过HTTP获取试卷HTML失败，使用备用方案', [ 'paper_id' => $paperId, 'url' => $url, ]); } catch (\Exception $e) { Log::warning('ExamPdfExportService: 通过HTTP获取试卷HTML异常', [ 'paper_id' => $paperId, 'error' => $e->getMessage(), ]); } // 备用方案：直接渲染视图 return $this->renderExamHtmlFromView($paperId, $includeAnswer, $useGradingView); } /** * 备用方案：直接渲染视图生成试卷HTML */ private function renderExamHtmlFromView(string $paperId, bool $includeAnswer, bool $useGradingView): ?string { try { $paper = Paper::with('questions')->find($paperId); if (! $paper) { Log::error('ExamPdfExportService: 试卷不存在', ['paper_id' => $paperId]); return null; } if ($paper->questions->isEmpty()) { Log::error('ExamPdfExportService: 试卷没有题目数据', [ 'paper_id' => $paperId, 'question_count' => 0, ]); return null; } $viewName = $this->resolveExamViewName($useGradingView); // 构造视图需要的变量 $questions = ['choice' => [], 'fill' => [], 'answer' => []]; foreach ($paper->questions as $pq) { $qType = $this->normalizeQuestionType($pq->question_type ?? 'answer'); $questions[$qType][] = $this->normalizeAnswerFieldForPdf($pq); } $studentModel = \App\Models\Student::find($paper->student_id); $teacherModel = \App\Models\Teacher::find($paper->teacher_id); if (! $teacherModel && ! empty($paper->teacher_id)) { $teacherModel = \App\Models\Teacher::query() ->where('teacher_id', $paper->teacher_id) ->first(); } $student = ['name' => $studentModel->name ?? ($paper->student_id ?? '________'), 'grade' => $studentModel->grade ?? '________']; $teacher = ['name' => $teacherModel->name ?? ($paper->teacher_id ?? '________')]; $examCode = PaperNaming::extractExamCode((string) $paper->paper_id); try { $assembleTypeLabel = PaperNaming::assembleTypeLabel((int) $paper->paper_type); } catch (\Throwable $e) { $assembleTypeLabel = '未知类型'; } $pdfMeta = [ 'student_name' => $student['name'], 'exam_code' => $examCode, 'assemble_type_label' => $assembleTypeLabel, 'header_title' => $examCode, 'exam_pdf_title' => '试卷_'.$examCode, 'grading_pdf_title' => '判卷_'.$examCode, 'knowledge_pdf_title' => '知识点讲解_'.$examCode, ]; $html = view($viewName, [ 'paper' => $paper, 'questions' => $questions, 'includeAnswer' => $includeAnswer, 'student' => $student, 'teacher' => $teacher, 'pdfMeta' => $pdfMeta, ])->render(); if (empty(trim($html))) { Log::error('ExamPdfExportService: 视图渲染结果为空', [ 'paper_id' => $paperId, 'view_name' => $viewName, 'question_count' => $paper->questions->count(), ]); return null; } return $this->ensureUtf8Html($html); } catch (\Exception $e) { Log::error('ExamPdfExportService: 备用方案渲染失败', [ 'paper_id' => $paperId, 'error' => $e->getMessage(), 'trace' => $e->getTraceAsString(), ]); return null; } } /** * 构建分析数据（重构版） * 优先使用本地MySQL数据，减少API依赖 */ private function buildAnalysisData(string $paperId, string $studentId): ?array { // 【关键调试】确认方法被调用 Log::warning('ExamPdfExportService: buildAnalysisData方法被调用了！', [ 'paper_id' => $paperId, 'student_id' => $studentId, 'timestamp' => now()->toISOString(), ]); $paper = Paper::with(['questions' => function ($query) { $query->orderBy('question_number')->orderBy('id'); }])->find($paperId); if (! $paper) { Log::warning('ExamPdfExportService: 未找到试卷，将尝试仅基于分析数据生成PDF', [ 'paper_id' => $paperId, 'student_id' => $studentId, ]); // 【修复】即使试卷不存在，也尝试基于分析数据生成PDF $paper = new \stdClass; $paper->paper_id = $paperId; $paper->paper_name = "学情分析报告_{$studentId}_{$paperId}"; $paper->question_count = 0; $paper->total_score = 0; $paper->created_at = now(); $paper->questions = collect(); } $student = Student::find($studentId); $studentInfo = [ 'id' => $student?->student_id ?? $studentId, 'name' => $student?->name ?? $studentId, 'grade' => $student?->grade ?? '未知年级', 'class' => $student?->class_name ?? '未知班级', ]; $teacherInfo = $this->getTeacherInfo((string) ($paper->teacher_id ?? '')); $assembleType = ($paper->paper_type === null || $paper->paper_type === '') ? null : (int) $paper->paper_type; try { $assembleTypeLabel = $assembleType !== null ? PaperNaming::assembleTypeLabel($assembleType) : '未知类型'; } catch (\Throwable $e) { $assembleTypeLabel = '未知类型'; } // 【修改】直接从本地数据库获取分析数据（不再调用API） $analysisData = []; // 首先尝试从paper->analysis_id获取 if (! empty($paper->analysis_id)) { Log::info('ExamPdfExportService: 从本地数据库获取试卷分析数据', [ 'paper_id' => $paperId, 'student_id' => $studentId, 'analysis_id' => $paper->analysis_id, ]); $analysisRecord = \DB::table('exam_analysis_results') ->where('id', $paper->analysis_id) ->where('student_id', $studentId) ->first(); if ($analysisRecord && ! empty($analysisRecord->analysis_data)) { $analysisData = json_decode($analysisRecord->analysis_data, true); Log::info('ExamPdfExportService: 成功获取本地分析数据（通过analysis_id）', [ 'data_size' => strlen($analysisRecord->analysis_data), ]); } else { Log::warning('ExamPdfExportService: 未找到本地分析数据，将尝试其他方式', [ 'paper_id' => $paperId, 'student_id' => $studentId, 'analysis_id' => $paper->analysis_id, ]); } } // 如果没有analysis_id或未找到数据，直接从exam_analysis_results表查询 if (empty($analysisData)) { Log::info('ExamPdfExportService: 直接从exam_analysis_results表查询分析数据', [ 'paper_id' => $paperId, 'student_id' => $studentId, ]); $analysisRecord = \DB::table('exam_analysis_results') ->where('paper_id', $paperId) ->where('student_id', $studentId) ->orderByDesc('created_at') ->first(); if ($analysisRecord && ! empty($analysisRecord->analysis_data)) { $analysisData = json_decode($analysisRecord->analysis_data, true); Log::info('ExamPdfExportService: 成功获取本地分析数据（直接查询）', [ 'data_size' => strlen($analysisRecord->analysis_data), 'question_count' => count($analysisData['question_analysis'] ?? []), ]); } else { Log::warning('ExamPdfExportService: 未找到任何分析数据，将使用空数据', [ 'paper_id' => $paperId, 'student_id' => $studentId, ]); } } // 【修复】优先使用analysisData中的knowledge_point_analysis数据 $masteryData = []; $parentMasteryLevels = []; // 新增：父节点掌握度数据 $allParentMasteryLevelsRaw = []; // 全量父节点掌握度（非本卷过滤） Log::info('ExamPdfExportService: 开始处理掌握度数据', [ 'student_id' => $studentId, 'analysisData_keys' => array_keys($analysisData), 'has_knowledge_point_analysis' => ! empty($analysisData['knowledge_point_analysis']), ]); $fullMasteryMap = []; $snapshotMasteryData = []; if (! empty($analysisData['knowledge_point_analysis'])) { // 将knowledge_point_analysis转换为buildMasterySummary期望的格式 foreach ($analysisData['knowledge_point_analysis'] as $kp) { $masteryData[] = [ 'kp_code' => $kp['kp_id'] ?? null, 'kp_name' => $kp['kp_id'] ?? '未知知识点', 'mastery_level' => $kp['mastery_level'] ?? 0, 'mastery_change' => $kp['change'] ?? null, ]; } // 【修复】基于所有兄弟节点历史数据计算父节点掌握度，并获取掌握度变化 try { // 获取本次考试涉及的知识点代码列表 $examKpCodes = array_column($masteryData, 'kp_code'); Log::info('ExamPdfExportService: 本次考试涉及的知识点', [ 'count' => count($examKpCodes), 'kp_codes' => $examKpCodes, ]); // 获取最新快照的数据（mastery_data 内已包含 current_mastery 和 previous_mastery） $lastSnapshot = DB::connection('mysql') ->table('knowledge_point_mastery_snapshots') ->where('student_id', $studentId) ->where('paper_id', $paper->paper_id) ->latest('snapshot_time') ->first(); $previousMasteryData = []; $snapshotMasteryData = []; if ($lastSnapshot) { $previousMasteryJson = json_decode($lastSnapshot->mastery_data, true); foreach ($previousMasteryJson as $kpCode => $data) { $snapshotMasteryData[$kpCode] = [ 'current_mastery' => isset($data['current_mastery']) ? floatval($data['current_mastery']) : null, 'previous_mastery' => isset($data['previous_mastery']) ? floatval($data['previous_mastery']) : null, 'change' => isset($data['change']) ? floatval($data['change']) : null, ]; $previousMasteryData[$kpCode] = [ 'current_mastery' => $data['current_mastery'] ?? 0, 'previous_mastery' => $data['previous_mastery'] ?? null, ]; } Log::info('ExamPdfExportService: 获取到上一次快照数据', [ 'snapshot_time' => $lastSnapshot->snapshot_time, 'kp_count' => count($previousMasteryData), ]); } // 为当前知识点添加变化数据 foreach ($masteryData as &$item) { $kpCode = $item['kp_code']; if (isset($previousMasteryData[$kpCode]) && $previousMasteryData[$kpCode]['previous_mastery'] !== null) { $previous = floatval($previousMasteryData[$kpCode]['previous_mastery']); $current = floatval($item['mastery_level']); $item['mastery_change'] = $current - $previous; } } unset($item); // 解除引用 // 获取所有父节点掌握度 $masteryOverview = $this->masteryCalculator->getStudentMasteryOverviewWithHierarchy($studentId); $allParentMasteryLevels = $masteryOverview['parent_mastery_levels'] ?? []; $allParentMasteryLevelsRaw = $allParentMasteryLevels; $overviewDetails = $masteryOverview['details'] ?? []; foreach ($overviewDetails as $detail) { if (is_object($detail)) { $code = $detail->kp_code ?? null; if ($code) { $fullMasteryMap[$code] = floatval($detail->mastery_level ?? 0); } } elseif (is_array($detail)) { $code = $detail['kp_code'] ?? null; if ($code) { $fullMasteryMap[$code] = floatval($detail['mastery_level'] ?? 0); } } } // 计算与本次考试相关的父节点掌握度（基于所有兄弟节点） $parentMasteryLevels = []; // 【修复】使用数据库查询正确匹配父子关系，而不是字符串前缀 foreach ($allParentMasteryLevels as $parentKpCode => $parentMastery) { // 查询这个父节点的所有子节点 $childNodes = DB::connection('mysql') ->table('knowledge_points') ->where('parent_kp_code', $parentKpCode) ->pluck('kp_code') ->toArray(); // 检查是否有子节点在本次考试中出现 $relevantChildren = array_intersect($examKpCodes, $childNodes); if (! empty($relevantChildren)) { // 口径统一：父节点掌握度 = 全部直接子节点（含未命中，缺失按0）均值 $childCurrentLevels = []; $childPreviousLevels = []; foreach ($childNodes as $childKpCode) { $currentChild = floatval($fullMasteryMap[$childKpCode] ?? 0); $childCurrentLevels[] = $currentChild; $prevFromSnapshot = $snapshotMasteryData[$childKpCode]['previous_mastery'] ?? null; $currFromSnapshot = $snapshotMasteryData[$childKpCode]['current_mastery'] ?? null; $previousChild = $prevFromSnapshot ?? $currFromSnapshot ?? $currentChild; $childPreviousLevels[] = floatval($previousChild); } $finalParentMastery = ! empty($childCurrentLevels) ? array_sum($childCurrentLevels) / count($childCurrentLevels) : floatval($parentMastery); $previousParentMastery = ! empty($childPreviousLevels) ? array_sum($childPreviousLevels) / count($childPreviousLevels) : $finalParentMastery; $finalParentChange = $finalParentMastery - $previousParentMastery; // 获取父节点中文名称 $parentKpInfo = DB::connection('mysql') ->table('knowledge_points') ->where('kp_code', $parentKpCode) ->first(); $parentMasteryLevels[$parentKpCode] = [ 'kp_code' => $parentKpCode, 'kp_name' => $parentKpInfo->name ?? $parentKpCode, 'mastery_level' => $finalParentMastery, 'mastery_percentage' => round($finalParentMastery * 100, 1), 'mastery_change' => $finalParentChange, 'change_source' => 'children_all_average', 'children' => $relevantChildren, ]; } } Log::info('ExamPdfExportService: 过滤后的父节点掌握度', [ 'all_parent_count' => count($allParentMasteryLevels), 'filtered_parent_count' => count($parentMasteryLevels), 'filtered_codes' => array_keys($parentMasteryLevels), ]); } catch (\Exception $e) { Log::warning('ExamPdfExportService: 获取父节点掌握度失败', [ 'error' => $e->getMessage(), ]); } Log::info('ExamPdfExportService: 使用analysisData中的掌握度数据', [ 'count' => count($masteryData), 'masteryData_sample' => ! empty($masteryData) ? array_slice($masteryData, 0, 2) : [], ]); } else { // 如果没有knowledge_point_analysis，使用MasteryCalculator获取多层级掌握度概览 try { Log::info('ExamPdfExportService: 获取学生多层级掌握度概览', [ 'student_id' => $studentId, ]); $masteryOverview = $this->masteryCalculator->getStudentMasteryOverviewWithHierarchy($studentId); $masteryData = $masteryOverview['details'] ?? []; $parentMasteryLevels = $masteryOverview['parent_mastery_levels'] ?? []; // 获取父节点掌握度 $allParentMasteryLevelsRaw = $parentMasteryLevels; // 【修复】将对象数组转换为关联数组（避免 stdClass 对象访问错误） if (! empty($masteryData) && is_array($masteryData)) { $masteryData = array_map(function ($item) { if (is_object($item)) { $kpCode = $item->kp_code ?? null; return [ 'kp_code' => $kpCode, 'kp_name' => $item->kp_name ?? null, 'mastery_level' => floatval($item->mastery_level ?? 0), 'mastery_change' => $item->mastery_change !== null ? floatval($item->mastery_change) : null, ]; } return $item; }, $masteryData); } foreach ($masteryData as $m) { $code = $m['kp_code'] ?? null; if ($code) { $fullMasteryMap[$code] = floatval($m['mastery_level'] ?? 0); } } // 【修复】获取快照数据以计算掌握度变化 $lastSnapshot = DB::connection('mysql') ->table('knowledge_point_mastery_snapshots') ->where('student_id', $studentId) ->latest('snapshot_time') ->first(); if ($lastSnapshot) { $previousMasteryJson = json_decode($lastSnapshot->mastery_data, true); foreach ($masteryData as &$item) { $kpCode = $item['kp_code']; if (isset($previousMasteryJson[$kpCode])) { $previous = floatval($previousMasteryJson[$kpCode]['previous_mastery'] ?? 0); $current = floatval($item['mastery_level']); $item['mastery_change'] = $current - $previous; } } unset($item); } Log::info('ExamPdfExportService: 成功获取多层级掌握度数据', [ 'count' => count($masteryData), 'parent_count' => count($parentMasteryLevels), ]); } catch (\Exception $e) { Log::error('ExamPdfExportService: 获取掌握度数据失败', [ 'student_id' => $studentId, 'error' => $e->getMessage(), ]); } } // 【修改】使用本地方法获取学习路径推荐（替代API调用） $recommendations = []; try { Log::info('ExamPdfExportService: 获取学习路径推荐', [ 'student_id' => $studentId, ]); $learningPaths = $this->learningAnalyticsService->recommendLearningPaths($studentId, 3); $recommendations = $learningPaths['recommendations'] ?? []; Log::info('ExamPdfExportService: 成功获取学习路径推荐', [ 'count' => count($recommendations), ]); } catch (\Exception $e) { Log::error('ExamPdfExportService: 获取学习路径推荐失败', [ 'student_id' => $studentId, 'error' => $e->getMessage(), ]); } // 获取知识点名称映射 $kpNameMap = $this->buildKnowledgePointNameMap(); Log::info('ExamPdfExportService: 获取知识点名称映射', [ 'kpNameMap_count' => count($kpNameMap), 'kpNameMap_keys_sample' => ! empty($kpNameMap) ? array_slice(array_keys($kpNameMap), 0, 5) : [], ]); // 【修复】直接从MySQL数据库获取题目详情（不通过API） // 只有当 $paper 是 Paper 模型时才查询题目详情 $questionDetails = ($paper instanceof \App\Models\Paper) ? $this->getQuestionDetailsFromMySQL($paper) : []; // 处理题目数据 $questions = $this->processQuestionsForReport($paper, $questionDetails, $kpNameMap); // 【关键调试】查看buildMasterySummary的返回结果 $masterySummary = $this->buildMasterySummary($masteryData, $kpNameMap); Log::info('ExamPdfExportService: buildMasterySummary返回结果', [ 'masteryData_count' => count($masteryData), 'kpNameMap_count' => count($kpNameMap), 'masterySummary_keys' => array_keys($masterySummary), 'masterySummary_items_count' => count($masterySummary['items'] ?? []), 'masterySummary_items_sample' => ! empty($masterySummary['items']) ? array_slice($masterySummary['items'], 0, 2) : [], ]); // 构建当前学生掌握度映射，供父子影响分析展示使用 $masteryMap = !empty($fullMasteryMap) ? $fullMasteryMap : []; if (empty($masteryMap)) { foreach ($masteryData as $m) { $code = $m['kp_code'] ?? null; if ($code) { $masteryMap[$code] = floatval($m['mastery_level'] ?? 0); } } } // 本卷命中知识点：严格按“这套卷子题目关联知识点”计算 $examQuestionKpCodes = array_values(array_unique(array_filter(array_map( fn ($q) => trim((string) ($q['knowledge_point'] ?? '')), $questions )))); // 父节点列表：直接按“本卷命中子知识点”反查父节点，避免历史全集/补齐口径带偏 $processedParentMastery = $this->buildParentMasteryFromHitCodes( $examQuestionKpCodes, $kpNameMap, $masteryMap, $snapshotMasteryData ); $processedFullParentMastery = $this->buildParentMasteryFromAllParents( $allParentMasteryLevelsRaw, $kpNameMap, $masteryMap, $snapshotMasteryData ); Log::info('ExamPdfExportService: 处理后的父节点掌握度', [ 'raw_count' => count($parentMasteryLevels), 'processed_count' => count($processedParentMastery), 'processed_sample' => ! empty($processedParentMastery) ? array_slice($processedParentMastery, 0, 3) : [], ]); return [ 'paper' => [ 'id' => $paper->paper_id, 'name' => $paper->paper_name, 'paper_type' => $paper->paper_type, 'assemble_type_label' => $assembleTypeLabel, 'total_questions' => $paper->question_count, 'total_score' => $paper->total_score, 'created_at' => $paper->created_at, ], 'student' => $studentInfo, 'teacher' => $teacherInfo, 'questions' => $questions, 'mastery' => $masterySummary, 'exam_hit_kp_codes' => $examQuestionKpCodes, 'parent_mastery_levels' => $processedParentMastery, // 【修复】使用处理后的父节点数据 'full_parent_mastery_levels' => $processedFullParentMastery, 'insights' => $analysisData['question_analysis'] ?? [], // 使用question_analysis替代question_results 'recommendations' => $recommendations, 'analysis_data' => $analysisData, ]; } /** * 【修复】直接从PaperQuestion表获取题目详情（不通过API） */ private function getQuestionDetailsFromMySQL(Paper $paper): array { $details = []; Log::info('ExamPdfExportService: 从PaperQuestion表查询题目详情', [ 'paper_id' => $paper->paper_id, 'question_count' => $paper->questions->count(), ]); foreach ($paper->questions as $pq) { try { // 【关键修复】直接从PaperQuestion对象获取solution和correct_answer $detail = [ 'id' => $pq->question_id, 'content' => $pq->question_text, 'question_type' => $pq->question_type, 'answer' => $pq->correct_answer ?? null, // 【修复】从PaperQuestion获取正确答案 'solution' => $pq->solution ?? null, // 【修复】从PaperQuestion获取解题思路 ]; $details[(string) ($pq->question_id ?? $pq->id)] = $detail; Log::debug('ExamPdfExportService: 成功获取题目详情', [ 'paper_question_id' => $pq->id, 'question_id' => $pq->question_id, 'has_answer' => ! empty($pq->correct_answer), 'has_solution' => ! empty($pq->solution), 'answer_preview' => $pq->correct_answer ? substr($pq->correct_answer, 0, 50) : null, ]); } catch (\Throwable $e) { Log::error('ExamPdfExportService: 获取题目详情失败', [ 'paper_question_id' => $pq->id, 'error' => $e->getMessage(), ]); } } return $details; } /** * 将题库 options 转为 [A=>文本, B=>文本, ...]，供学情报告展示 * * @param mixed $raw questions.options（JSON/数组） * @return array */ private function normalizeChoiceOptionsMap($raw): array { if ($raw === null || $raw === '') { return []; } if (is_string($raw)) { $decoded = json_decode($raw, true); $raw = is_array($decoded) ? $decoded : []; } if (! is_array($raw)) { return []; } $out = []; foreach ($raw as $k => $v) { if (is_string($k) && preg_match('/([A-H])/i', $k, $m)) { $letter = strtoupper($m[1]); $text = is_array($v) ? (string) ($v['content'] ?? $v['text'] ?? $v['value'] ?? '') : (string) $v; $text = trim($text); if ($text !== '') { $out[$letter] = $text; } } } if (! empty($out)) { return $out; } $letters = ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H']; $i = 0; foreach ($raw as $v) { if ($i >= count($letters)) { break; } $text = is_array($v) ? (string) ($v['content'] ?? $v['text'] ?? $v['value'] ?? '') : (string) $v; $text = trim($text); if ($text !== '') { $out[$letters[$i]] = $text; } $i++; } return $out; } /** * 从题干 HTML 中解析选项（与 ExamPdfController::extractOptions 口径一致，输出为字母=>文本） * * @return array */ private function extractChoiceOptionsFromStem(string $content): array { $out = []; $contentWithoutSvg = preg_replace('/]*>.*?<\/svg>/is', '[SVG_PLACEHOLDER]', $content); $pattern = '/(?:^|\s)([A-H])[\.、：．:]\s*(.+?)(?=(?:^|\s)[A-H][\.、：．:]|$)/su'; if (preg_match_all($pattern, $contentWithoutSvg, $matches, PREG_SET_ORDER)) { foreach ($matches as $match) { $letter = strtoupper($match[1]); $optionText = trim($match[2]); $optionText = preg_replace('/\s+$/', '', $optionText); $optionText = preg_replace('/^\$\$\s*/', '', $optionText); $optionText = preg_replace('/\s*\$\$$/', '', $optionText); if ($optionText !== '') { $out[$letter] = $optionText; } } } if (empty($out)) { $lines = preg_split('/[\r\n]+/', $contentWithoutSvg); foreach ($lines as $line) { $line = trim($line); if (preg_match('/^([A-H])[\.、：．:]\s*(.+)$/u', $line, $match)) { $letter = strtoupper($match[1]); $optionText = trim($match[2]); if ($optionText !== '') { $out[$letter] = $optionText; } } } } return $out; } /** * 处理题目数据（用于报告） */ private function processQuestionsForReport($paper, array $questionDetails, array $kpNameMap): array { $grouped = [ 'choice' => [], 'fill' => [], 'answer' => [], ]; // 【修复】处理空的试卷（questions可能不存在） $questions = $paper->questions ?? collect(); if ($questions->isEmpty()) { Log::info('ExamPdfExportService: 试卷没有题目，返回空数组'); return $grouped; } $sortedQuestions = $questions ->sortBy(function ($q, int $idx) { $number = $q->question_number ?? $idx + 1; return is_numeric($number) ? (float) $number : ($q->id ?? $idx); }); $bankIds = $sortedQuestions->pluck('question_bank_id')->filter()->unique()->values()->all(); $optionsByBankId = []; if (! empty($bankIds)) { $optionsByBankId = Question::whereIn('id', $bankIds) ->pluck('options', 'id') ->toArray(); } foreach ($sortedQuestions as $idx => $question) { $kpCode = $question->knowledge_point ?? ''; $kpName = $kpNameMap[$kpCode] ?? $kpCode ?: '未标注'; // 【修复】直接从PaperQuestion对象获取solution和correct_answer $answer = $question->correct_answer ?? null; // 直接从PaperQuestion获取 $solution = $question->solution ?? null; // 直接从PaperQuestion获取 $detail = $questionDetails[(string) ($question->question_id ?? $question->id)] ?? []; $typeRaw = $question->question_type ?? ($detail['question_type'] ?? $detail['type'] ?? ''); $normalizedType = $this->normalizeQuestionType($typeRaw); $number = $question->question_number ?? ($idx + 1); // 处理题干文本 $questionText = is_array($question->question_text) ? json_encode($question->question_text, JSON_UNESCAPED_UNICODE) : ($question->question_text ?? ''); $optionsFromBank = $question->question_bank_id ? ($optionsByBankId[$question->question_bank_id] ?? null) : null; $choiceOptionsMap = $this->normalizeChoiceOptionsMap($optionsFromBank); if (empty($choiceOptionsMap) && $normalizedType === 'choice') { $choiceOptionsMap = $this->extractChoiceOptionsFromStem((string) $questionText); } $questionTextForPayload = $this->formatNewlines($questionText); $questionTextPreprocessed = false; if ($normalizedType === 'choice') { $questionTextForPayload = GradingStyleQuestionStem::buildChoiceStemForReport( (string) $questionTextForPayload ); $questionTextPreprocessed = true; } $payload = [ 'question_id' => $question->question_id ?? null, 'question_bank_id' => $question->question_bank_id ?? $question->question_id ?? null, 'question_number' => $number, 'question_text' => $questionTextForPayload, 'question_text_preprocessed' => $questionTextPreprocessed, 'question_type' => $normalizedType, 'knowledge_point' => $kpCode, 'knowledge_point_name' => $kpName, 'score' => $question->score, 'answer' => $this->formatNewlines($answer), // 格式化换行 'solution' => $this->formatNewlines($solution), // 格式化换行 'student_answer' => $this->formatNewlines($question->student_answer ?? null), // 格式化换行 'correct_answer' => $this->formatNewlines($answer), // 格式化换行 'is_correct' => $question->is_correct ?? null, 'score_obtained' => $question->score_obtained ?? null, 'options' => $choiceOptionsMap, ]; $grouped[$normalizedType][] = $payload; // 【调试】记录题目数据 Log::debug('ExamPdfExportService: 处理题目数据', [ 'paper_question_id' => $question->id, 'question_id' => $question->question_id, 'has_answer' => ! empty($answer), 'has_solution' => ! empty($solution), 'answer_preview' => $answer ? substr($answer, 0, 50) : null, ]); } $ordered = array_merge($grouped['choice'], $grouped['fill'], $grouped['answer']); // 按卷面顺序重新编号 foreach ($ordered as $i => &$q) { $q['display_number'] = $i + 1; } unset($q); return $ordered; } /** * 构建PDF */ private function buildPdf(string $html, bool $applyWideImageSizing = false, bool $scopeToExamPart = false): ?string { $tmpHtml = tempnam(sys_get_temp_dir(), 'exam_html_').'.html'; $utf8Html = $this->ensureUtf8Html($html); if ($applyWideImageSizing) { $utf8Html = $scopeToExamPart ? $this->applyAdaptiveWideImageSizingToExamPart($utf8Html) : $this->applyAdaptiveWideImageSizing($utf8Html); } $written = file_put_contents($tmpHtml, $utf8Html); Log::debug('ExamPdfExportService: HTML文件已创建', [ 'path' => $tmpHtml, 'html_length' => strlen($utf8Html), 'written_bytes' => $written, ]); // 【调试】如果启用了HTML保存调试，复制HTML到storage用于分析 if (config('pdf.debug_save_html', false)) { $debugPath = storage_path('app/debug_pdf_'.date('YmdHis').'.html'); @copy($tmpHtml, $debugPath); Log::warning('ExamPdfExportService: [DEBUG] HTML副本已保存', ['path' => $debugPath]); } // 仅使用Chrome渲染 $chromePdf = $this->renderWithChrome($tmpHtml); @unlink($tmpHtml); return $chromePdf; } /** * 对扁长/超扁长图片做全局自适应放大，普通图片不处理。 */ private function applyAdaptiveWideImageSizing(string $html): string { return (string) preg_replace_callback( '/]*\bsrc=(["\'])([^"\']+)\1[^>]*>/i', function (array $m): string { $fullTag = $m[0] ?? ''; $src = $m[2] ?? ''; if ($fullTag === '' || $src === '' || str_starts_with($src, 'data:')) { return $fullTag; } if (! $this->shouldApplyAdaptiveSizingToSrc($src)) { return $fullTag; } $dim = $this->getPdfImageDimensions($src); if (! $dim || ($dim['w'] ?? 0) <= 0 || ($dim['h'] ?? 0) <= 0) { return $fullTag; } $ratio = $dim['w'] / max(1, $dim['h']); if ($ratio < 2.8) { return $fullTag; } $targetWidth = $ratio >= 3.5 ? self::PDF_IMAGE_WIDTH_VERY_WIDE_PX : self::PDF_IMAGE_WIDTH_WIDE_PX; $targetWidth = min($targetWidth, $dim['w']); $targetStyle = sprintf( 'width:%dpx!important;max-width:%dpx!important;max-height:60mm!important;height:auto!important;object-fit:contain!important;', $targetWidth, $targetWidth ); if (preg_match('/\sstyle=(["\'])(.*?)\1/i', $fullTag, $sm)) { $originStyle = $sm[2] ?? ''; $originStyle = preg_replace('/\bmax-width\s*:[^;]+;?/i', '', $originStyle); $originStyle = preg_replace('/\bmax-height\s*:[^;]+;?/i', '', $originStyle); $originStyle = preg_replace('/\bwidth\s*:[^;]+;?/i', '', $originStyle); $originStyle = preg_replace('/\bheight\s*:[^;]+;?/i', '', $originStyle); $originStyle = preg_replace('/\bobject-fit\s*:[^;]+;?/i', '', $originStyle); $newStyle = $targetStyle.trim((string) $originStyle); return preg_replace( '/\sstyle=(["\'])(.*?)\1/i', ' style="'.$newStyle.'"', $fullTag, 1 ) ?? $fullTag; } return preg_replace('/applyAdaptiveWideImageSizing($examContent); return substr($html, 0, $contentStart).$processedExamContent.substr($html, $endPos); } /** * @return array{w:int,h:int}|null */ private function getPdfImageDimensions(string $src): ?array { if (array_key_exists($src, $this->pdfImageDimensionCache)) { return $this->pdfImageDimensionCache[$src]; } try { $persisted = $this->getPersistedPdfImageMetrics($src); if ($persisted !== null) { $this->pdfImageDimensionCache[$src] = $persisted; return $persisted; } if (! str_starts_with($src, 'http://') && ! str_starts_with($src, 'https://')) { $this->pdfImageDimensionCache[$src] = null; return null; } $size = @getimagesize($src); if (is_array($size) && count($size) >= 2) { $data = ['w' => (int) $size[0], 'h' => (int) $size[1]]; $this->persistPdfImageMetrics($src, $data); $this->pdfImageDimensionCache[$src] = $data; return $data; } $this->pdfImageDimensionCache[$src] = null; return null; } catch (\Throwable $e) { Log::debug('ExamPdfExportService: 图片尺寸探测失败', ['src' => $src, 'error' => $e->getMessage()]); $this->pdfImageDimensionCache[$src] = null; return null; } } /** * @return array{w:int,h:int}|null */ private function getPersistedPdfImageMetrics(string $src): ?array { if (! $this->isPdfImageMetricsTableReady()) { return null; } $row = DB::table('pdf_image_metrics') ->where('src', $src) ->first(['width', 'height']); if (! $row) { return null; } $w = (int) ($row->width ?? 0); $h = (int) ($row->height ?? 0); if ($w <= 0 || $h <= 0) { return null; } return ['w' => $w, 'h' => $h]; } /** * @param array{w:int,h:int} $data */ private function persistPdfImageMetrics(string $src, array $data): void { if (! $this->isPdfImageMetricsTableReady()) { return; } $w = (int) ($data['w'] ?? 0); $h = (int) ($data['h'] ?? 0); if ($w <= 0 || $h <= 0) { return; } DB::table('pdf_image_metrics')->upsert([ [ 'src' => $src, 'width' => $w, 'height' => $h, 'ratio' => round($w / max(1, $h), 4), 'updated_at' => now(), 'created_at' => now(), ], ], ['src'], ['width', 'height', 'ratio', 'updated_at']); } private function isPdfImageMetricsTableReady(): bool { if ($this->hasPdfImageMetricsTable !== null) { return $this->hasPdfImageMetricsTable; } $this->hasPdfImageMetricsTable = Schema::hasTable('pdf_image_metrics'); return $this->hasPdfImageMetricsTable; } private function shouldApplyAdaptiveSizingToSrc(string $src): bool { $parts = parse_url($src); if (! is_array($parts)) { return false; } $host = strtolower((string) ($parts['host'] ?? '')); $path = (string) ($parts['path'] ?? ''); if ($host !== 'file.chunsunqiuzhu.com') { return false; } if (! str_contains($path, '/data/')) { return false; } return (bool) preg_match('/\.(png|jpe?g|webp)$/i', $path); } /** * 使用Chrome渲染PDF */ private function renderWithChrome(string $htmlPath): ?string { $tmpPdf = tempnam(sys_get_temp_dir(), 'exam_pdf_').'.pdf'; $userDataDir = sys_get_temp_dir().'/chrome-profile-'.uniqid(); $chromeBinary = $this->findChromeBinary(); if (! $chromeBinary) { Log::error('ExamPdfExportService: 未找到可用的Chrome/Chromium'); return null; } // 设置运行时目录 $runtimeHome = sys_get_temp_dir().'/chrome-home'; $runtimeXdg = sys_get_temp_dir().'/chrome-xdg'; if (! File::exists($runtimeHome)) { @File::makeDirectory($runtimeHome, 0755, true); } if (! File::exists($runtimeXdg)) { @File::makeDirectory($runtimeXdg, 0755, true); } $process = new Process([ $chromeBinary, '--headless=new', // 【优化】使用新渲染引擎 '--disable-gpu', '--no-sandbox', '--disable-setuid-sandbox', '--disable-dev-shm-usage', '--disable-web-security', '--disable-features=VizDisplayCompositor', '--disable-extensions', // '--disable-background-networking', // 注释掉，可能阻止必要的网络请求 '--disable-component-update', '--disable-client-side-phishing-detection', '--disable-default-apps', '--disable-domain-reliability', '--disable-sync', '--no-first-run', '--no-default-browser-check', '--disable-crash-reporter', '--disable-print-preview', '--disable-features=TranslateUI', '--disable-features=OptimizationHints', '--disable-ipc-flooding-protection', '--disable-background-timer-throttling', '--disable-backgrounding-occluded-windows', '--disable-renderer-backgrounding', '--disable-features=AudioServiceOutOfProcess', '--disable-gpu-sandbox', '--disable-software-rasterizer', '--disable-background-mode', '--disable-extensions-http-throttling', '--disable-ipc-flooding-protection', '--disable-features=Dbus', // 禁用 dbus // 【关键修复】添加虚拟时间预算，让Chrome有足够时间加载CDN资源和执行JS '--virtual-time-budget=30000', // 30秒虚拟时间用于加载外部资源 '--run-all-compositor-stages-before-draw', // 确保所有渲染完成后再生成PDF '--user-data-dir='.$userDataDir, '--print-to-pdf='.$tmpPdf, '--print-to-pdf-no-header', '--allow-file-access-from-files', '--font-render-hinting=none', // 【优化】禁用字体渲染提示 '--disable-font-antialiasing', 'file://'.$htmlPath, ], null, [ 'HOME' => $runtimeHome, 'XDG_RUNTIME_DIR' => $runtimeXdg, ]); $process->setTimeout(180); // 复杂学情报告页允许更长渲染时间，降低超时失败率 $killSignal = \defined('SIGKILL') ? \SIGKILL : 9; Log::warning('ExamPdfExportService: [调试] Chrome命令准备执行', [ 'chrome_binary' => $chromeBinary, 'html_path' => $htmlPath, 'html_exists' => file_exists($htmlPath), 'html_size' => file_exists($htmlPath) ? filesize($htmlPath) : 0, 'pdf_path' => $tmpPdf, 'user_data_dir' => $userDataDir, ]); try { $startedAt = microtime(true); $process->start(); $pdfGenerated = false; // 轮询检测PDF是否生成 $pollStart = microtime(true); $maxPollSeconds = 80; // 【修复】增加轮询超时到80秒 while ($process->isRunning() && (microtime(true) - $pollStart) < $maxPollSeconds) { if (file_exists($tmpPdf) && filesize($tmpPdf) > 0) { $pdfGenerated = true; Log::info('ExamPdfExportService: PDF生成成功，提前终止Chrome进程', [ 'elapsed' => round(microtime(true) - $startedAt, 2), 'pdf_size' => filesize($tmpPdf), ]); $process->stop(3, $killSignal); // 【优化】减少停止等待时间 break; } usleep(100_000); // 【优化】从200ms减少到100ms } if ($process->isRunning()) { $process->stop(3, $killSignal); // 【优化】减少停止等待时间 } // 【优化】删除不必要的wait()调用，避免重复等待 // $process->wait(); } catch (ProcessTimedOutException|ProcessSignaledException $e) { if ($process->isRunning()) { $process->stop(3, $killSignal); // 【优化】减少停止等待时间 } Log::warning('ExamPdfExportService: Chrome进程超时或被信号中断', [ 'elapsed' => round((microtime(true) - $startedAt), 2), 'exception' => get_class($e), ]); $result = $this->handleChromeProcessResult($tmpPdf, $userDataDir, $process, $startedAt); if ($result !== null) { return $result; } return $this->renderWithChromeMinimal($chromeBinary, $htmlPath); } catch (\Throwable $e) { if ($process->isRunning()) { $process->stop(3, $killSignal); // 【优化】减少停止等待时间 } Log::error('ExamPdfExportService: Chrome进程异常', [ 'elapsed' => round((microtime(true) - $startedAt), 2), 'error' => $e->getMessage(), ]); $result = $this->handleChromeProcessResult($tmpPdf, $userDataDir, $process, null); if ($result !== null) { return $result; } return $this->renderWithChromeMinimal($chromeBinary, $htmlPath); } $result = $this->handleChromeProcessResult($tmpPdf, $userDataDir, $process, null); if ($result !== null) { return $result; } return $this->renderWithChromeMinimal($chromeBinary, $htmlPath); } /** * 处理Chrome进程结果 */ private function handleChromeProcessResult(string $tmpPdf, string $userDataDir, Process $process, ?float $startedAt): ?string { $pdfExists = file_exists($tmpPdf); $pdfSize = $pdfExists ? filesize($tmpPdf) : null; $elapsed = $startedAt ? round((microtime(true) - $startedAt), 2) : null; // 【优化】即使进程未成功，只要PDF存在且大小合理就返回 if ($pdfExists && $pdfSize > 1000) { // 至少1KB Log::info('ExamPdfExportService: PDF生成成功', [ 'elapsed' => $elapsed, 'pdf_size' => $pdfSize, 'exit_code' => $process->getExitCode(), 'is_successful' => $process->isSuccessful(), ]); $pdfBinary = file_get_contents($tmpPdf); @unlink($tmpPdf); File::deleteDirectory($userDataDir); return $pdfBinary; } // 如果PDF不存在或太小，记录错误 Log::error('ExamPdfExportService: Chrome渲染失败', [ 'elapsed' => $elapsed, 'pdf_exists' => $pdfExists, 'pdf_size' => $pdfSize, 'exit_code' => $process->getExitCode(), 'error' => $process->getErrorOutput(), 'output' => $process->getOutput(), ]); @unlink($tmpPdf); File::deleteDirectory($userDataDir); return null; } /** * Chrome主渲染失败时的最小参数兜底。 */ private function renderWithChromeMinimal(string $chromeBinary, string $htmlPath): ?string { $tmpPdf = tempnam(sys_get_temp_dir(), 'exam_pdf_fallback_').'.pdf'; $process = new Process([ $chromeBinary, '--headless=new', '--disable-gpu', '--no-sandbox', '--print-to-pdf='.$tmpPdf, 'file://'.$htmlPath, ]); $process->setTimeout(180); try { $process->run(); if (file_exists($tmpPdf) && filesize($tmpPdf) > 1000) { Log::warning('ExamPdfExportService: Chrome最小参数兜底成功', [ 'pdf_size' => filesize($tmpPdf), 'exit_code' => $process->getExitCode(), ]); $pdfBinary = file_get_contents($tmpPdf); @unlink($tmpPdf); return $pdfBinary; } Log::error('ExamPdfExportService: Chrome最小参数兜底失败', [ 'exit_code' => $process->getExitCode(), 'error' => $process->getErrorOutput(), 'output' => $process->getOutput(), ]); } catch (\Throwable $e) { Log::error('ExamPdfExportService: Chrome最小参数兜底异常', [ 'error' => $e->getMessage(), ]); } @unlink($tmpPdf); return null; } /** * 查找Chrome二进制文件 */ private function findChromeBinary(): ?string { $candidates = [ env('PDF_CHROME_BINARY'), env('CHROME_BIN'), // Docker Alpine 环境变量 '/usr/bin/chromium-browser', // Alpine Linux '/usr/bin/chromium', '/usr/bin/google-chrome-stable', '/usr/bin/google-chrome', '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', // macOS ]; foreach ($candidates as $path) { if ($path && is_file($path) && is_executable($path)) { return $path; } } return null; } /** * 确保HTML为UTF-8编码，并内联外部资源 */ private function ensureUtf8Html(string $html): string { $meta = ''; if (stripos($html, '') !== false) { $html = preg_replace('//i', "{$meta}", $html, 1); } else { $html = $meta.$html; } // 【关键修复】内联KaTeX CSS，避免Chrome在容器中加载CDN资源超时 $html = $this->inlineExternalResources($html); return $html; } /** * 将CDN资源替换为内联资源 * 【关键修复】避免Chrome在容器中加载CDN资源超时，同时支持本地路径 */ private function inlineExternalResources(string $html): string { // 检查是否包含 KaTeX 资源（CDN 或本地） $hasKatexCdn = strpos($html, 'cdn.jsdelivr.net/npm/katex') !== false; $hasKatexLocal = strpos($html, '/js/katex.min.js') !== false || strpos($html, '/css/katex/katex.min.css') !== false; // 【调试】记录HTML内容信息 Log::warning('ExamPdfExportService: inlineExternalResources', [ 'html_length' => strlen($html), 'has_katex_cdn' => $hasKatexCdn, 'has_katex_local' => $hasKatexLocal, ]); // 如果既没有 CDN 也没有本地链接，跳过 if (! $hasKatexCdn && ! $hasKatexLocal) { Log::warning('ExamPdfExportService: HTML 中没有 KaTeX 资源链接，跳过内联'); return $html; } try { // 读取并内联 KaTeX CSS（无论 CDN 还是本地） $katexCssPath = public_path('css/katex/katex.min.css'); if (file_exists($katexCssPath)) { $katexCss = file_get_contents($katexCssPath); // 修复字体路径：将相对路径改为 data URI $fontsDir = public_path('css/katex/fonts'); $katexCss = preg_replace_callback( '/url\(["\']?fonts\/([^"\')\s]+)["\']?\)/i', function ($matches) use ($fontsDir) { $fontFile = $fontsDir.'/'.$matches[1]; if (file_exists($fontFile)) { $fontData = base64_encode(file_get_contents($fontFile)); $mimeType = str_ends_with($matches[1], '.woff2') ? 'font/woff2' : 'font/woff'; return 'url(data:'.$mimeType.';base64,'.$fontData.')'; } return $matches[0]; }, $katexCss ); // 替换 CDN CSS 链接 if ($hasKatexCdn) { $html = preg_replace( '/]*href=["\']https:\/\/cdn\.jsdelivr\.net\/npm\/katex[^"\']*katex\.min\.css["\'][^>]*>/i', '', $html ); } // 替换本地 CSS 链接 if ($hasKatexLocal) { $html = preg_replace( '/]*href=["\']\/css\/katex\/katex\.min\.css["\'][^>]*>/i', '', $html ); } Log::info('ExamPdfExportService: KaTeX CSS 已内联（含字体 data URI）'); } // 读取本地 KaTeX JS（用于移除） $katexJsPath = public_path('js/katex.min.js'); $autoRenderJsPath = public_path('js/auto-render.min.js'); if (file_exists($katexJsPath)) { $katexJs = file_get_contents($katexJsPath); $html = preg_replace( '/]*src=["\']https:\/\/cdn\.jsdelivr\.net\/npm\/katex[^"\']*katex\.min\.js["\'][^>]*><\/script>/i', '', $html ); } if (file_exists($autoRenderJsPath)) { $autoRenderJs = file_get_contents($autoRenderJsPath); $html = preg_replace( '/]*src=["\']https:\/\/cdn\.jsdelivr\.net\/npm\/katex[^"\']*auto-render[^"\']*["\'][^>]*><\/script>/i', '', $html ); } // 【关键修复】使用服务端预渲染，而不是依赖客户端 JavaScript // Chrome headless 的 --print-to-pdf 不会等待 JS 执行完成 // 所以我们使用 Node.js KaTeX 在服务端预渲染所有公式 // 1. 移除所有 KaTeX JavaScript（不再需要，因为使用服务端渲染） // 移除内联的 katex.min.js $html = preg_replace( '/]*type=["\']text\/javascript["\'][^>]*>[\s\S]*?katex[\s\S]*?<\/script>/i', '', $html ); // 移除 DOMContentLoaded 监听器 $html = preg_replace( '/]*>[\s\S]*?document\.addEventListener[\s\S]*?DOMContentLoaded[\s\S]*?<\/script>/i', '', $html ); // 2. 使用 KatexRenderer 进行服务端预渲染 if ($this->katexRenderer) { $beforeLength = strlen($html); $html = $this->katexRenderer->renderHtml($html); $afterLength = strlen($html); Log::info('ExamPdfExportService: LaTeX 公式服务端预渲染完成', [ 'before_length' => $beforeLength, 'after_length' => $afterLength, 'size_change' => $afterLength - $beforeLength, ]); } else { Log::warning('ExamPdfExportService: KatexRenderer 未初始化，跳过预渲染'); } // 【换行处理】将字面的 \n 转换为
标签（在 KaTeX 渲染后处理，避免破坏公式） // 先替换所有 \n 为
，然后合并连续的
（最多保留2个） $html = str_replace('\\n', '
', $html); $html = preg_replace('/(
\s*){3,}/', '

', $html); // 3个以上合并为2个 } catch (\Exception $e) { Log::warning('ExamPdfExportService: 内联资源处理失败，保留原始HTML', [ 'error' => $e->getMessage(), ]); } return $html; } /** * 【新增】合并两个HTML页面，插入分页符 * 保留原始页面样式和结构，只在中间插入分页符 */ private function mergeHtmlWithPageBreak(string $examHtml, string $gradingHtml, ?string $kpExplainHtml = null): ?string { try { // 确保HTML编码正确 $examHtml = $this->ensureUtf8Html($examHtml); $gradingHtml = $this->ensureUtf8Html($gradingHtml); if ($kpExplainHtml) { $kpExplainHtml = $this->ensureUtf8Html($kpExplainHtml); } // 提取body内容 $examBody = $this->extractBodyContent($examHtml); $gradingBody = $this->extractBodyContent($gradingHtml); // 知识点讲解使用专门的提取方法，避免嵌套完整HTML结构 $kpExplainBody = $kpExplainHtml ? $this->extractKpExplainContent($kpExplainHtml) : null; if (empty($examBody) || empty($gradingBody)) { Log::error('ExamPdfExportService: HTML内容提取失败', [ 'exam_body_length' => strlen($examBody), 'grading_body_length' => strlen($gradingBody), ]); return null; } // 提取head内容（保留原始样式和meta信息） $examHead = $this->extractHeadContent($examHtml); $gradingHead = $this->extractHeadContent($gradingHtml); $kpExplainHead = $kpExplainHtml ? $this->extractHeadContent($kpExplainHtml) : null; // 构建统一HTML文档（保留原始结构） $unifiedHtml = $this->buildUnifiedHtmlWithOriginalStructure( $examHead, $examBody, $gradingBody, $gradingHead, $kpExplainBody, $kpExplainHead ); Log::info('HTML合并成功（保留原始样式）', [ 'exam_length' => strlen($examBody), 'grading_length' => strlen($gradingBody), 'kp_explain_length' => $kpExplainBody ? strlen($kpExplainBody) : 0, 'unified_length' => strlen($unifiedHtml), 'head_length' => strlen($examHead), 'has_kp_explain' => ! empty($kpExplainBody), ]); return $unifiedHtml; } catch (\Throwable $e) { Log::error('mergeHtmlWithPageBreak 失败', [ 'error' => $e->getMessage(), 'trace' => $e->getTraceAsString(), ]); return null; } } /** * 【新增】提取HTML的body内容 */ private function extractBodyContent(string $html): string { // 匹配body标签内容 if (preg_match('/]*>(.*)<\/body>/is', $html, $matches)) { return $matches[1]; } // 如果没有body标签，返回整个HTML return $html; } /** * 【新增】提取HTML的head内容 * 保留原始页面的样式和meta信息 */ private function extractHeadContent(string $html): string { // 匹配head标签内容 if (preg_match('/]*>(.*)<\/head>/is', $html, $matches)) { return $matches[1]; } // 如果没有head标签，返回默认meta return ''; } /** * 【新增】提取知识点讲解的核心内容 * 只提取 kp-explain 容器内部的内容，避免嵌套完整的HTML结构 */ private function extractKpExplainContent(string $html): string { // 如果 HTML 中包含嵌套的 标签，提取嵌套内容 if (preg_match('/]*>(.*)<\/html>/is', $html, $htmlMatches)) { $html = $htmlMatches[1]; } // 如果 HTML 中包含 标签，跳过 head if (preg_match('/]*>.*?<\/head>/is', $html, $headMatch)) { $html = substr($html, strpos($html, '') + 7); } // 如果 HTML 中包含 标签，提取 body 内容 if (preg_match('/]*>(.*)<\/body>/is', $html, $bodyMatches)) { $html = $bodyMatches[1]; } // 移除可能存在的嵌套 , , 标签 $html = preg_replace('/<\/?(html|head|body)[^>]*>/is', '', $html); // 移除 script 标签和注释 $html = preg_replace('/]*>.*?<\/script>/is', '', $html); $html = preg_replace('//is', '', $html); return trim($html); } /** * 【优化重构】构建统一的HTML文档（容器结构 + 消除空白页） * 使用容器结构替代空的 page-break div，避免中间出现空白页 */ private function buildUnifiedHtmlWithOriginalStructure( string $examHead, string $examBody, string $gradingBody, string $gradingHead, ?string $kpExplainBody = null, ?string $kpExplainHead = null ): string { // 清洗内容：移除可能存在的分页符，避免双重分页 $examBody = $this->stripPageBreakElements($examBody); $gradingBody = $this->stripPageBreakElements($gradingBody); if ($kpExplainBody) { $kpExplainBody = $this->stripPageBreakElements($kpExplainBody); } // 合并 head 内容：试卷 head + 判卷 head + 知识点讲解 head（去重）+ 分页控制样式 $mergedHead = $examHead; // 按顺序合并其他 head 里的 '; // 构建HTML内容 $bodyContent = ''; $mergedTitle = '试卷与判卷合并'; if (preg_match('/ '.$headContent.' '.$bodyContent.' '; } /** * 【新增】清洗HTML内容中的分页符元素 * 移除可能存在的 page-break 元素，避免双重分页导致空白页 */ private function stripPageBreakElements(string $content): string { // 只移除空的 page-break div 元素（通常是

） // 使用更精确的正则，只匹配空内容或纯空白内容的 div $patterns = [ '/]*class="[^"]*page-break[^"]*"[^>]*>\s*<\/div>/si', '/]*style="[^"]*page-break[^"]*"[^>]*>\s*<\/div>/si', ]; foreach ($patterns as $pattern) { $content = preg_replace($pattern, '', $content); } return $content; } /** * 【新增】获取PDF通用样式 */ private function getCommonPdfStyles(): string { return ' * { margin: 0; padding: 0; box-sizing: border-box; } body { font-family: "Microsoft YaHei", "SimHei", Arial, sans-serif; font-size: 14px; line-height: 1.6; color: #333; background: #fff; } .paper-container { max-width: 210mm; margin: 0 auto; padding: 20mm; background: white; } .paper-header { text-align: center; margin-bottom: 30px; padding-bottom: 15px; border-bottom: 2px solid #333; } .paper-title { font-size: 24px; font-weight: bold; margin-bottom: 10px; } .paper-info { font-size: 14px; color: #666; } .question { margin-bottom: 30px; padding: 20px; border: 1px solid #ddd; border-radius: 5px; } .question-number { font-weight: bold; margin-bottom: 10px; } .question-stem { margin-bottom: 15px; } .options { list-style: none; margin-left: 20px; } .options li { margin-bottom: 8px; } .answer-section { margin-top: 20px; padding-top: 15px; border-top: 1px solid #eee; } .answer-label { font-weight: bold; color: #d9534f; } .solution { margin-top: 10px; padding: 10px; background: #f5f5f5; border-left: 4px solid #5bc0de; } '; } /** * 构建知识点名称映射 */ private function buildKnowledgePointNameMap(): array { try { $options = $this->questionServiceApi->getKnowledgePointOptions(); return $options ?: []; } catch (\Throwable $e) { Log::warning('ExamPdfExportService: 获取知识点名称失败', [ 'error' => $e->getMessage(), ]); return []; } } /** * 构建掌握度摘要 */ private function buildMasterySummary(array $masteryData, array $kpNameMap): array { Log::info('ExamPdfExportService: buildMasterySummary开始处理', [ 'masteryData_count' => count($masteryData), 'kpNameMap_count' => count($kpNameMap), ]); $items = []; $total = 0; $count = 0; foreach ($masteryData as $row) { $code = $row['kp_code'] ?? null; // 【修复】使用kpNameMap转换名称为友好显示名 $name = $kpNameMap[$code] ?? $row['kp_name'] ?? $code ?: '未知知识点'; $level = (float) ($row['mastery_level'] ?? 0); $delta = $row['mastery_change'] ?? null; $items[] = [ 'kp_code' => $code, 'kp_name' => $name, 'mastery_level' => $level, 'mastery_change' => $delta, ]; $total += $level; $count++; } $average = $count > 0 ? round($total / $count, 2) : null; // 按掌握度从低到高排序 if (! empty($items)) { usort($items, fn ($a, $b) => ($a['mastery_level'] <=> $b['mastery_level'])); } $result = [ 'items' => $items, 'average' => $average, 'weak_list' => array_slice($items, 0, 5), ]; Log::info('ExamPdfExportService: buildMasterySummary完成', [ 'total_count' => $count, 'items_count' => count($items), ]); return $result; } /** * 标准化题型 */ private function normalizeQuestionType(string $type): string { $t = strtolower(trim($type)); return match (true) { str_contains($t, 'choice') || str_contains($t, '选择') => 'choice', str_contains($t, 'fill') || str_contains($t, 'blank') || str_contains($t, '填空') => 'fill', default => 'answer', }; } private function buildPaperNamePrefix(Paper $paper): string { $assembleType = ($paper->paper_type === null || $paper->paper_type === '') ? null : (int) $paper->paper_type; $studentName = Student::query() ->where('student_id', $paper->student_id) ->value('name') ?? ($paper->student_id ?: '________'); try { $assembleTypeLabel = $assembleType !== null ? PaperNaming::assembleTypeLabel($assembleType) : '未知类型'; } catch (\Throwable $e) { $assembleTypeLabel = '未知类型'; } return "{$studentName}_".PaperNaming::extractExamCode((string) $paper->paper_id)."_{$assembleTypeLabel}"; } private function buildPaperDisplayTitle(Paper $paper): string { return $this->buildPaperNamePrefix($paper).'_'.now()->format('Ymd'); } private function buildPdfFileName(Paper $paper, ?string $stamp = null): string { $basePrefix = $this->buildPaperNamePrefix($paper); $stamp = $stamp ?: now()->format('YmdHis').strtoupper(Str::random(4)); $base = "{$basePrefix}_{$stamp}"; $safe = PaperNaming::toSafeFilename($base); return "{$safe}.pdf"; } private function extractUploadStamp(string $url): ?string { $path = parse_url($url, PHP_URL_PATH); if (! is_string($path) || $path === '') { return null; } $stem = pathinfo($path, PATHINFO_FILENAME); if (! is_string($stem) || $stem === '') { return null; } if (preg_match('/(\d{14}[A-Za-z0-9]{4})/', $stem, $matches)) { return $matches[1]; } return null; } /** * 保存PDF URL到数据库 */ private function savePdfUrlToDatabase(string $paperId, string $field, string $url): void { try { $paper = Paper::where('paper_id', $paperId)->first(); if ($paper) { $paperDisplayTitle = $this->buildPaperDisplayTitle($paper); $stamp = $this->extractUploadStamp($url); if ($stamp) { $paperDisplayTitle = $this->buildPaperNamePrefix($paper).'_'.$stamp; } $updatePayload = [ $field => $url, 'paper_name' => $paperDisplayTitle, ]; $paper->update($updatePayload); Log::info('ExamPdfExportService: PDF URL已写入数据库', [ 'paper_id' => $paperId, 'field' => $field, 'url' => $url, 'paper_name' => $paperDisplayTitle, ]); } } catch (\Throwable $e) { Log::error('ExamPdfExportService: 写入PDF URL失败', [ 'paper_id' => $paperId, 'field' => $field, 'error' => $e->getMessage(), ]); } } /** * 保存学情分析PDF URL */ private function saveAnalysisPdfUrl(string $paperId, string $studentId, ?string $recordId, string $url): void { try { if ($recordId) { // OCR记录 $ocrRecord = \App\Models\OCRRecord::find($recordId); if ($ocrRecord) { $ocrRecord->update(['analysis_pdf_url' => $url]); Log::info('ExamPdfExportService: OCR记录学情分析PDF URL已写入数据库', [ 'record_id' => $recordId, 'paper_id' => $paperId, 'student_id' => $studentId, 'url' => $url, ]); } } else { // 【修复】同时更新 exam_analysis_results 表和分析报告表 $updated = \DB::connection('mysql')->table('exam_analysis_results') ->where('student_id', $studentId) ->where('paper_id', $paperId) ->update([ 'analysis_pdf_url' => $url, 'updated_at' => now(), ]); if ($updated) { Log::info('ExamPdfExportService: 学情分析PDF URL已写入exam_analysis_results表', [ 'student_id' => $studentId, 'paper_id' => $paperId, 'url' => $url, 'updated_rows' => $updated, ]); } else { Log::warning('ExamPdfExportService: 未找到要更新的学情分析记录', [ 'student_id' => $studentId, 'paper_id' => $paperId, ]); } // 学生记录 - 使用新的 student_reports 表（备用） \App\Models\StudentReport::updateOrCreate( [ 'student_id' => $studentId, 'report_type' => 'exam_analysis', 'paper_id' => $paperId, ], [ 'pdf_url' => $url, 'generation_status' => 'completed', 'generated_at' => now(), 'updated_at' => now(), ] ); Log::info('ExamPdfExportService: 学生学情报告PDF URL已保存到student_reports表（备用）', [ 'student_id' => $studentId, 'paper_id' => $paperId, 'url' => $url, ]); } } catch (\Throwable $e) { Log::error('ExamPdfExportService: 写入学情分析PDF URL失败', [ 'paper_id' => $paperId, 'student_id' => $studentId, 'record_id' => $recordId, 'error' => $e->getMessage(), ]); } } /** * 【修复】处理父节点掌握度数据 * 1. 过滤掉掌握度为0或null的父节点 * 2. 将kp_code转换为友好的kp_name * 3. 构建父子层级关系（只显示本次考试相关的子节点） */ private function processParentMasteryLevels( array $parentMasteryLevels, array $kpNameMap, array $examKpCodes = [], array $masteryMap = [], array $snapshotMasteryData = [] ): array { $processed = []; foreach ($parentMasteryLevels as $kpCode => $masteryData) { // 兼容不同数据结构：可能是数组或数字 $masteryLevel = is_array($masteryData) ? ($masteryData['mastery_level'] ?? 0) : $masteryData; $masteryChange = is_array($masteryData) ? ($masteryData['mastery_change'] ?? null) : null; $changeSource = is_array($masteryData) ? ($masteryData['change_source'] ?? null) : null; // 获取友好名称 $kpName = $kpNameMap[$kpCode] ?? $kpCode; // 构建父节点数据，包含子节点信息（只显示本次考试相关的） $childrenData = $this->getChildKnowledgePoints($kpCode, $kpNameMap, $examKpCodes, $masteryMap); $allChildren = $childrenData['all_children'] ?? []; // 口径统一：优先使用全部直接子节点均值作为父节点掌握度 if (! empty($allChildren)) { $allLevels = array_map( fn ($c) => floatval($c['mastery_level'] ?? 0), $allChildren ); $masteryLevel = ! empty($allLevels) ? array_sum($allLevels) / count($allLevels) : floatval($masteryLevel); if (! empty($snapshotMasteryData)) { $prevLevels = []; foreach ($allChildren as $child) { $childCode = (string) ($child['kp_code'] ?? ''); if ($childCode === '') { continue; } $currentChild = floatval($masteryMap[$childCode] ?? 0); $prevFromSnapshot = $snapshotMasteryData[$childCode]['previous_mastery'] ?? null; $currFromSnapshot = $snapshotMasteryData[$childCode]['current_mastery'] ?? null; $previousChild = $prevFromSnapshot ?? $currFromSnapshot ?? $currentChild; $prevLevels[] = floatval($previousChild); } if (! empty($prevLevels)) { $masteryChange = $masteryLevel - (array_sum($prevLevels) / count($prevLevels)); $changeSource = 'children_all_average'; } } } // 仅过滤空值；0 掌握度的命中父节点也要展示 if ($masteryLevel === null) { continue; } $hitLevels = array_map( fn ($c) => floatval($c['mastery_level'] ?? 0), $childrenData['hit_children'] ?? [] ); $hitAvg = ! empty($hitLevels) ? array_sum($hitLevels) / count($hitLevels) : null; $hitCount = count($childrenData['hit_children'] ?? []); // 父节点仅展示“本卷命中知识点”对应的父节点 if ($hitCount <= 0) { continue; } $processed[$kpCode] = [ 'kp_code' => $kpCode, 'kp_name' => $kpName, 'mastery_level' => round(floatval($masteryLevel), 4), 'mastery_percentage' => round(floatval($masteryLevel) * 100, 2), 'mastery_change' => $masteryChange !== null ? round(floatval($masteryChange), 4) : null, 'change_source' => $changeSource, // 兼容旧模板字段：仅命中子节点 'children' => $childrenData['hit_children'] ?? [], // 新增：全部直接子节点（含掌握度、是否命中） 'children_all' => $childrenData['all_children'] ?? [], 'children_hit_count' => $hitCount, 'children_total_count' => count($childrenData['all_children'] ?? []), 'children_hit_avg_mastery' => $hitAvg !== null ? round($hitAvg, 4) : null, 'level' => $this->calculateKnowledgePointLevel($kpCode), ]; } // 按掌握度降序排序 uasort($processed, function ($a, $b) { return $b['mastery_level'] <=> $a['mastery_level']; }); return $processed; } /** * 【修复】获取子知识点列表（只返回本次考试涉及的） */ private function getChildKnowledgePoints(string $parentKpCode, array $kpNameMap, array $examKpCodes = [], array $masteryMap = []): array { $allChildren = []; $hitChildren = []; try { $childCodes = DB::connection('mysql') ->table('knowledge_points') ->where('parent_kp_code', $parentKpCode) ->pluck('kp_code') ->toArray(); foreach ($childCodes as $childCode) { $isHit = in_array($childCode, $examKpCodes); $childData = [ 'kp_code' => $childCode, 'kp_name' => $kpNameMap[$childCode] ?? $childCode, 'mastery_level' => floatval($masteryMap[$childCode] ?? 0), 'is_hit' => $isHit, ]; $allChildren[] = $childData; if ($isHit) { $hitChildren[] = $childData; } } } catch (\Exception $e) { Log::warning('获取子知识点失败', [ 'parent_kp_code' => $parentKpCode, 'error' => $e->getMessage(), ]); } return [ 'all_children' => $allChildren, 'hit_children' => $hitChildren, ]; } /** * 当历史父节点概览缺失时，直接由“本卷命中知识点”反推出父节点并构建展示数据。 */ private function buildParentMasteryFromHitCodes( array $examKpCodes, array $kpNameMap, array $masteryMap = [], array $snapshotMasteryData = [] ): array { $codes = array_values(array_unique(array_filter(array_map(fn ($c) => trim((string) $c), $examKpCodes)))); if (empty($codes)) { return []; } $rows = DB::connection('mysql') ->table('knowledge_points') ->whereIn('kp_code', $codes) ->whereNotNull('parent_kp_code') ->where('parent_kp_code', '!=', '') ->select('kp_code', 'parent_kp_code') ->get(); $parentMap = []; foreach ($rows as $r) { $parentCode = trim((string) ($r->parent_kp_code ?? '')); $childCode = trim((string) ($r->kp_code ?? '')); if ($parentCode === '' || $childCode === '') { continue; } $parentMap[$parentCode][] = $childCode; } if (empty($parentMap)) { return []; } $parents = DB::connection('mysql') ->table('knowledge_points') ->whereIn('kp_code', array_keys($parentMap)) ->pluck('name', 'kp_code') ->toArray(); $processed = []; foreach ($parentMap as $parentCode => $hitChildrenCodes) { $childrenData = $this->getChildKnowledgePoints($parentCode, $kpNameMap, $codes, $masteryMap); $allChildren = $childrenData['all_children'] ?? []; $hitChildren = $childrenData['hit_children'] ?? []; $hitCount = count($hitChildren); if ($hitCount <= 0) { continue; } $allLevels = array_map(fn ($c) => floatval($c['mastery_level'] ?? 0), $allChildren); $masteryLevel = !empty($allLevels) ? array_sum($allLevels) / count($allLevels) : 0.0; $prevLevels = []; foreach ($allChildren as $child) { $childCode = (string) ($child['kp_code'] ?? ''); if ($childCode === '') { continue; } $currentChild = floatval($masteryMap[$childCode] ?? 0); $prevFromSnapshot = $snapshotMasteryData[$childCode]['previous_mastery'] ?? null; $currFromSnapshot = $snapshotMasteryData[$childCode]['current_mastery'] ?? null; $previousChild = $prevFromSnapshot ?? $currFromSnapshot ?? $currentChild; $prevLevels[] = floatval($previousChild); } $masteryChange = !empty($prevLevels) ? ($masteryLevel - (array_sum($prevLevels) / count($prevLevels))) : null; $hitLevels = array_map(fn ($c) => floatval($c['mastery_level'] ?? 0), $hitChildren); $hitAvg = !empty($hitLevels) ? array_sum($hitLevels) / count($hitLevels) : null; $processed[$parentCode] = [ 'kp_code' => $parentCode, 'kp_name' => $parents[$parentCode] ?? ($kpNameMap[$parentCode] ?? $parentCode), 'mastery_level' => round(floatval($masteryLevel), 4), 'mastery_percentage' => round(floatval($masteryLevel) * 100, 2), 'mastery_change' => $masteryChange !== null ? round(floatval($masteryChange), 4) : null, 'change_source' => 'hit_kp_parent_fallback', 'children' => $hitChildren, 'children_all' => $allChildren, 'children_hit_count' => $hitCount, 'children_total_count' => count($allChildren), 'children_hit_avg_mastery' => $hitAvg !== null ? round($hitAvg, 4) : null, 'level' => $this->calculateKnowledgePointLevel($parentCode), ]; } uasort($processed, fn ($a, $b) => $b['mastery_level'] <=> $a['mastery_level']); return $processed; } /** * 基于学生全量掌握度构建父节点列表（不按本卷命中过滤） */ private function buildParentMasteryFromAllParents( array $allParentMasteryLevels, array $kpNameMap, array $masteryMap = [], array $snapshotMasteryData = [] ): array { if (empty($allParentMasteryLevels)) { return []; } $parentCodes = []; foreach ($allParentMasteryLevels as $code => $value) { $parentCode = trim((string) $code); if ($parentCode === '') { continue; } $parentCodes[] = $parentCode; } $parentCodes = array_values(array_unique($parentCodes)); if (empty($parentCodes)) { return []; } $parents = DB::connection('mysql') ->table('knowledge_points') ->whereIn('kp_code', $parentCodes) ->pluck('name', 'kp_code') ->toArray(); $processed = []; foreach ($parentCodes as $parentCode) { $raw = $allParentMasteryLevels[$parentCode] ?? null; $rawMastery = is_array($raw) ? floatval($raw['mastery_level'] ?? 0) : (is_object($raw) ? floatval($raw->mastery_level ?? 0) : floatval($raw ?? 0)); $childrenData = $this->getChildKnowledgePoints($parentCode, $kpNameMap, [], $masteryMap); $allChildren = $childrenData['all_children'] ?? []; $allLevels = array_map(fn ($c) => floatval($c['mastery_level'] ?? 0), $allChildren); $masteryLevel = ! empty($allLevels) ? (array_sum($allLevels) / count($allLevels)) : $rawMastery; $prevLevels = []; foreach ($allChildren as $child) { $childCode = (string) ($child['kp_code'] ?? ''); if ($childCode === '') { continue; } $currentChild = floatval($masteryMap[$childCode] ?? 0); $prevFromSnapshot = $snapshotMasteryData[$childCode]['previous_mastery'] ?? null; $currFromSnapshot = $snapshotMasteryData[$childCode]['current_mastery'] ?? null; $previousChild = $prevFromSnapshot ?? $currFromSnapshot ?? $currentChild; $prevLevels[] = floatval($previousChild); } $masteryChange = ! empty($prevLevels) ? ($masteryLevel - (array_sum($prevLevels) / count($prevLevels))) : null; $processed[$parentCode] = [ 'kp_code' => $parentCode, 'kp_name' => $parents[$parentCode] ?? ($kpNameMap[$parentCode] ?? $parentCode), 'mastery_level' => round(floatval($masteryLevel), 4), 'mastery_percentage' => round(floatval($masteryLevel) * 100, 2), 'mastery_change' => $masteryChange !== null ? round(floatval($masteryChange), 4) : null, 'change_source' => 'full_mastery_overview', 'children' => [], 'children_all' => $allChildren, 'children_hit_count' => 0, 'children_total_count' => count($allChildren), 'children_hit_avg_mastery' => null, 'level' => $this->calculateKnowledgePointLevel($parentCode), ]; } uasort($processed, fn ($a, $b) => $b['mastery_level'] <=> $a['mastery_level']); return $processed; } /** * 计算知识点层级深度 */ private function calculateKnowledgePointLevel(string $kpCode): int { // 根据kp_code前缀判断层级深度 // 例如: M (1级) -> M01 (2级) -> M01A (3级) if (preg_match('/^[A-Z]+$/', $kpCode)) { return 1; // 一级分类，如 M, S, E, G } elseif (preg_match('/^[A-Z]+\d+$/', $kpCode)) { return 2; // 二级分类，如 M01, S02 } elseif (preg_match('/^[A-Z]+\d+[A-Z]+$/', $kpCode)) { return 3; // 三级分类，如 M01A, S02B } elseif (preg_match('/^[A-Z]+\d+[A-Z]+\d+$/', $kpCode)) { return 4; // 四级分类，如 M01A1 } return 1; // 默认一级 } /** * 构建题目数据（用于PDF生成） */ private function buildQuestionsData(Paper $paper): array { $paperQuestions = $paper->questions()->orderBy('question_number')->get(); $questionsData = []; foreach ($paperQuestions as $pq) { $questionsData[] = [ 'id' => $pq->question_bank_id, 'question_number' => $pq->question_number, // 传递原始题号，确保渲染时序号正确 'kp_code' => $pq->knowledge_point, 'question_type' => $pq->question_type ?? 'answer', 'stem' => $pq->question_text ?? '题目内容缺失', 'solution' => $pq->solution ?? '', 'answer' => $pq->correct_answer ?? '', 'difficulty' => $pq->difficulty ?? 0.5, 'score' => $pq->score ?? 5, 'tags' => '', 'content' => $pq->question_text ?? '', ]; } // 获取完整题目详情 if (! empty($questionsData)) { $questionIds = array_column($questionsData, 'id'); $questionsResponse = $this->questionServiceApi->getQuestionsByIds($questionIds); $responseData = $questionsResponse['data'] ?? []; if (! empty($responseData)) { $responseDataMap = []; foreach ($responseData as $respQ) { $responseDataMap[$respQ['id']] = $respQ; } $questionsData = array_map(function ($q) use ($responseDataMap) { if (isset($responseDataMap[$q['id']])) { $apiData = $responseDataMap[$q['id']]; $q['stem'] = $apiData['stem'] ?? $q['stem'] ?? $q['content'] ?? ''; $q['content'] = $q['stem']; $q['answer'] = $apiData['answer'] ?? $q['answer'] ?? ''; $q['solution'] = $apiData['solution'] ?? $q['solution'] ?? ''; $q['tags'] = $apiData['tags'] ?? $q['tags'] ?? ''; $q['options'] = $apiData['options'] ?? []; } return $q; }, $questionsData); } } // 按题型分类 $classified = ['choice' => [], 'fill' => [], 'answer' => []]; foreach ($questionsData as $q) { $type = $this->determineQuestionType($q); $classified[$type][] = (object) $q; } // 【调试】记录题目分类情况 Log::debug('buildQuestionsData: 题目分类结果', [ 'total_questions' => count($questionsData), 'choice_count' => count($classified['choice']), 'fill_count' => count($classified['fill']), 'answer_count' => count($classified['answer']), 'choice_numbers' => array_map(fn ($q) => $q->question_number ?? 'N/A', $classified['choice']), 'fill_numbers' => array_map(fn ($q) => $q->question_number ?? 'N/A', $classified['fill']), 'answer_numbers' => array_map(fn ($q) => $q->question_number ?? 'N/A', $classified['answer']), ]); return $classified; } /** * 获取学生信息 */ private function getStudentInfo(?string $studentId): array { if (! $studentId) { return [ 'name' => '未知学生', 'grade' => '未知年级', 'class' => '未知班级', ]; } try { $student = DB::table('students') ->where('student_id', $studentId) ->first(); if ($student) { return [ 'name' => $student->name ?? $studentId, 'grade' => $student->grade ?? '未知', 'class' => $student->class ?? '未知', ]; } } catch (\Exception $e) { Log::warning('获取学生信息失败', [ 'student_id' => $studentId, 'error' => $e->getMessage(), ]); } return [ 'name' => $studentId, 'grade' => '未知', 'class' => '未知', ]; } /** * 获取教师信息 */ private function getTeacherInfo(?string $teacherId): array { if (! $teacherId) { return [ 'name' => '未知老师', 'subject' => '数学', ]; } try { $query = DB::table('teachers')->where('teacher_id', $teacherId); // 仅在列存在时追加，避免 Unknown column 'id' if (Schema::hasColumn('teachers', 'id')) { $query->orWhere('id', $teacherId); } $teacher = $query->first(); if ($teacher) { return [ 'name' => $teacher->name ?? '________', 'subject' => $teacher->subject ?? '数学', ]; } } catch (\Exception $e) { Log::warning('获取教师信息失败', [ 'teacher_id' => $teacherId, 'error' => $e->getMessage(), ]); } return [ 'name' => '________', 'subject' => '数学', ]; } /** * 判断题目类型 * 【修复】优先使用 question_type 字段，避免选择题因含有（）被误判为填空题 */ private function determineQuestionType(array $question): string { // 1. 【优先】根据已有类型字段判断（最可靠的来源） if (! empty($question['question_type'])) { $type = strtolower(trim($question['question_type'])); if (in_array($type, ['choice', '选择题'])) { return 'choice'; } if (in_array($type, ['fill', '填空题'])) { return 'fill'; } if (in_array($type, ['answer', '解答题'])) { return 'answer'; } } // 2. 如果没有明确类型，则根据题干内容推断 $stem = $question['stem'] ?? $question['content'] ?? ''; if (is_string($stem)) { // 检查是否有选项模式 A. B. C. D. $hasOptionA = preg_match('/\bA\s*[\.\、\:]/', $stem) || preg_match('/\(A\)/', $stem) || preg_match('/^A[\.\s]/', $stem); $hasOptionB = preg_match('/\bB\s*[\.\、\:]/', $stem) || preg_match('/\(B\)/', $stem) || preg_match('/^B[\.\s]/', $stem); $hasOptionC = preg_match('/\bC\s*[\.\、\:]/', $stem) || preg_match('/\(C\)/', $stem) || preg_match('/^C[\.\s]/', $stem); $hasOptionD = preg_match('/\bD\s*[\.\、\:]/', $stem) || preg_match('/\(D\)/', $stem) || preg_match('/^D[\.\s]/', $stem); $optionCount = ($hasOptionA ? 1 : 0) + ($hasOptionB ? 1 : 0) + ($hasOptionC ? 1 : 0) + ($hasOptionD ? 1 : 0); if ($optionCount >= 2) { return 'choice'; } // 检查是否有填空标记（但要排除选择题的括号） if (preg_match('/（\s*）|\(\s*\)/', $stem)) { return 'fill'; } } // 3. 默认返回解答题 return 'answer'; } /** * 格式化换行符：将字面的 \n 转换为 HTML
标签 * 用于 PDF 渲染时正确显示换行 */ private function formatNewlines(?string $text): ?string { if ($text === null) { return null; } // 【修复】替换 \n 为
，但保护 LaTeX 命令如 \neq, \ne, \newline, \nu 等 // 使用负向前瞻 (?![a-zA-Z]) 避免误伤 LaTeX 命令 $text = preg_replace('/\\\\n(?![a-zA-Z])/', '
', $text); // 合并连续的
（最多保留2个） return preg_replace('/(
\s*){3,}/', '

', $text); } /** * 根据指定的题目生成PDF（新增方法） * * @param object $paper 虚拟试卷对象 * @param array $groupedQuestions 按题型分组的题目数据 * @param array $student 学生信息 ['name' => '', 'grade' => ''] * @param array $teacher 教师信息 ['name' => ''] * @param bool $includeGrading 是否包含判卷版本 * @return array 返回 ['pdf_url' => '...', 'grading_pdf_url' => '...'] */ public function generateByQuestions( object $paper, array $groupedQuestions, array $student = [], array $teacher = [], bool $includeGrading = false ): array { Log::info('generateByQuestions 开始', [ 'paper_id' => $paper->paper_id, 'question_counts' => [ 'choice' => count($groupedQuestions['choice'] ?? []), 'fill' => count($groupedQuestions['fill'] ?? []), 'answer' => count($groupedQuestions['answer'] ?? []), ], 'include_grading' => $includeGrading, ]); try { $result = []; // 1. 生成试卷PDF（不含答案） $examHtml = $this->renderCustomExamHtml($paper, $groupedQuestions, $student, $teacher, false); if ($examHtml) { // 【修复】使用服务端 KaTeX 预渲染 LaTeX 公式 if ($this->katexRenderer) { $examHtml = $this->katexRenderer->renderHtml($examHtml); } $examPdf = $this->buildPdf($examHtml); if ($examPdf) { $examPath = "custom_exams/{$paper->paper_id}_exam.pdf"; $examUrl = $this->pdfStorageService->put($examPath, $examPdf); $result['pdf_url'] = $examUrl; Log::info('试卷PDF生成成功', ['url' => $examUrl]); } } // 2. 如果需要，生成判卷PDF（含答案） if ($includeGrading) { $gradingHtml = $this->renderCustomExamHtml($paper, $groupedQuestions, $student, $teacher, true); if ($gradingHtml) { // 【修复】使用服务端 KaTeX 预渲染 LaTeX 公式 if ($this->katexRenderer) { $gradingHtml = $this->katexRenderer->renderHtml($gradingHtml); } $gradingPdf = $this->buildPdf($gradingHtml); if ($gradingPdf) { $gradingPath = "custom_exams/{$paper->paper_id}_grading.pdf"; $gradingUrl = $this->pdfStorageService->put($gradingPath, $gradingPdf); $result['grading_pdf_url'] = $gradingUrl; Log::info('判卷PDF生成成功', ['url' => $gradingUrl]); } } } return $result; } catch (\Throwable $e) { Log::error('generateByQuestions 失败', [ 'paper_id' => $paper->paper_id, 'error' => $e->getMessage(), 'trace' => $e->getTraceAsString(), ]); throw $e; } } /** * 题目质检专用 PDF：固定使用判题卡体系模板（答案详解 + 判题卡）。 * 不进入正常组卷流程，仅用于检查题干、答案、解题思路渲染效果。 * * @return array{pdf_url?: string} */ public function generateQuestionCheckPdf( object $paper, array $groupedQuestions, array $student = [], array $teacher = [] ): array { Log::info('generateQuestionCheckPdf 开始', [ 'paper_id' => $paper->paper_id ?? null, 'question_counts' => [ 'choice' => count($groupedQuestions['choice'] ?? []), 'fill' => count($groupedQuestions['fill'] ?? []), 'answer' => count($groupedQuestions['answer'] ?? []), ], ]); $studentName = $student['name'] ?? ($paper->student_id ?? '________'); $examCode = \App\Support\PaperNaming::extractExamCode((string) ($paper->paper_id ?? 'custom')); $pdfMeta = [ 'student_name' => $studentName, 'exam_code' => $examCode, 'assemble_type_label' => '题目质检', 'header_title' => $examCode, 'exam_pdf_title' => '题目质检_'.$examCode, 'grading_pdf_title' => '题目质检_'.$examCode, 'knowledge_pdf_title' => '题目质检_'.$examCode, ]; try { // 固定走题目质检专用模板：题干+答案+解题思路 + 判题卡附页 $html = view('pdf.question-check', [ 'paper' => $paper, 'questions' => $groupedQuestions, 'student' => $student, 'teacher' => $teacher, 'pdfMeta' => $pdfMeta, ])->render(); if (empty(trim($html))) { Log::error('generateQuestionCheckPdf: HTML 渲染为空', [ 'paper_id' => $paper->paper_id ?? null, ]); return []; } if ($this->katexRenderer) { $html = $this->katexRenderer->renderHtml($html); } $pdfBinary = $this->buildPdf($this->ensureUtf8Html($html)); if (empty($pdfBinary)) { Log::error('generateQuestionCheckPdf: buildPdf 失败', [ 'paper_id' => $paper->paper_id ?? null, ]); return []; } $path = 'custom_exams/'.($paper->paper_id ?? ('custom_'.time())).'.pdf'; $url = $this->pdfStorageService->put($path, $pdfBinary); if (! $url) { Log::error('generateQuestionCheckPdf: 上传失败', [ 'paper_id' => $paper->paper_id ?? null, 'path' => $path, ]); return []; } return [ 'pdf_url' => $url, 'grading_pdf_url' => $url, ]; } catch (\Throwable $e) { Log::error('generateQuestionCheckPdf 失败', [ 'paper_id' => $paper->paper_id ?? null, 'error' => $e->getMessage(), 'trace' => $e->getTraceAsString(), ]); throw $e; } } /** * 渲染自定义题目的HTML */ private function renderCustomExamHtml( object $paper, array $groupedQuestions, array $student, array $teacher, bool $grading ): ?string { try { $viewName = $this->resolveExamViewName($grading); $html = view($viewName, [ 'paper' => $paper, 'questions' => $groupedQuestions, 'student' => $student, 'teacher' => $teacher, 'grading' => $grading, 'includeAnswer' => false, // exam-paper 视图需要这个变量 ])->render(); if (empty(trim($html))) { Log::error('renderCustomExamHtml: 视图渲染结果为空', [ 'paper_id' => $paper->paper_id, 'view_name' => $viewName, ]); return null; } return $this->ensureUtf8Html($html); } catch (\Exception $e) { Log::error('renderCustomExamHtml 失败', [ 'paper_id' => $paper->paper_id, 'error' => $e->getMessage(), 'trace' => $e->getTraceAsString(), ]); return null; } } private function resolveExamViewName(bool $useGradingView): string { if (! $useGradingView) { return 'pdf.exam-paper'; } return config('exam.pdf_grading_append_scan_sheet', false) ? 'pdf.exam-answer-detail' : 'pdf.exam-grading'; } private function normalizeAnswerFieldForPdf(object $question): object { $normalizedQuestion = clone $question; // 以 paper_questions.question_text 为标准题干字段，兼容旧链路 content。 $questionText = trim((string) ($normalizedQuestion->question_text ?? '')); if ($questionText === '') { $questionText = trim((string) ($normalizedQuestion->content ?? '')); } if ($questionText !== '') { $normalizedQuestion->question_text = $questionText; $normalizedQuestion->content = $questionText; } $answerText = trim((string) ($normalizedQuestion->answer ?? '')); if ($answerText !== '') { return $normalizedQuestion; } foreach (['correct_answer', 'standard_answer', 'reference_answer'] as $fallbackField) { $candidate = trim((string) ($normalizedQuestion->{$fallbackField} ?? '')); if ($candidate !== '') { $normalizedQuestion->answer = $candidate; break; } } return $normalizedQuestion; } /** * 生成预览 PDF（用于题目预览验证工具） * * @param array $questionData 题目数据 ['stem', 'options', 'answer', 'solution', 'question_type'] * @return array|null 返回 ['url' => '...'] 或 null */ public function generatePreviewPdf(array $questionData): ?array { try { Log::info('generatePreviewPdf 开始', ['question_data' => $questionData]); // 渲染 HTML $html = $this->renderPreviewHtml($questionData); if (empty($html)) { Log::error('generatePreviewPdf: HTML 渲染为空'); return null; } // 生成 PDF $pdfContent = $this->buildPdf($html); if (empty($pdfContent)) { Log::error('generatePreviewPdf: PDF 生成为空'); return null; } // 保存到临时目录 $filename = 'preview_'.uniqid().'.pdf'; $path = "previews/{$filename}"; $url = $this->pdfStorageService->put($path, $pdfContent); Log::info('generatePreviewPdf 成功', ['url' => $url]); return ['url' => $url]; } catch (\Exception $e) { Log::error('generatePreviewPdf 失败', [ 'error' => $e->getMessage(), 'trace' => $e->getTraceAsString(), ]); return null; } } /** * 渲染预览 HTML */ private function renderPreviewHtml(array $questionData): string { $stem = $questionData['stem'] ?? ''; $options = $questionData['options'] ?? null; $answer = $questionData['answer'] ?? ''; $solution = $questionData['solution'] ?? ''; $questionType = $questionData['question_type'] ?? 'fill'; // 使用 MathFormulaProcessor 处理公式 $processedStem = MathFormulaProcessor::processFormulas($stem); $processedAnswer = MathFormulaProcessor::processFormulas($answer); $processedSolution = MathFormulaProcessor::processFormulas($this->formatNewlines($solution)); $processedOptions = null; if ($options && is_array($options)) { $processedOptions = []; foreach ($options as $key => $value) { $processedOptions[$key] = MathFormulaProcessor::processFormulas($value); } } // 渲染 HTML return view('pdf.question-preview', [ 'stem' => $processedStem, 'options' => $processedOptions, 'answer' => $processedAnswer, 'solution' => $processedSolution, 'questionType' => $questionType, ])->render(); } /** * 批量获取知识点的讲解内容 * * @param array $kpCodes 知识点代码数组 * @return array [kp_code => explanation] */ public function buildExplanations(array $kpCodes): array { $result = []; if (empty($kpCodes)) { return $result; } try { // 批量获取知识点讲解 $kps = \App\Models\KnowledgePoint::whereIn('kp_code', $kpCodes)->get()->keyBy('kp_code'); // 有多少算多少 foreach ($kpCodes as $kpCode) { $kp = $kps->get($kpCode); if ($kp && ! empty($kp->explanation)) { $result[] = [ 'kp_code' => $kpCode, 'kp_name' => $kp->name ?? $kpCode, 'explanation' => $this->normalizeKpExplanation($kp->explanation), ]; continue; } $result[] = [ 'kp_code' => $kpCode, 'kp_name' => $kp->name ?? $kpCode, 'explanation' => $this->normalizeKpExplanation( $this->getDefaultExplanation($kpCode, $kp->name ?? $kpCode) ), ]; } } catch (\Throwable $e) { Log::warning('批量获取知识点讲解失败', [ 'kp_codes' => $kpCodes, 'error' => $e->getMessage(), ]); // 失败时返回默认内容 foreach ($kpCodes as $kpCode) { $result[] = [ 'kp_code' => $kpCode, 'kp_name' => $kpCode, 'explanation' => $this->normalizeKpExplanation( $this->getDefaultExplanation($kpCode, $kpCode) ), ]; } } return $result; } /** * 获取默认的知识点讲解内容 */ private function getDefaultExplanation(string $kpCode, string $kpName): string { // 默认讲解模板 // 注意：PHP HEREDOC 中 \e 会被解释为 ESC 字符，所以需要用 \\end 而非 \end return <<<'MARKDOWN' ## 知识点 (1) 核心定义：二元一次方程是含有两个未知数且每个未知数的次数都是 1 的方程，一般形式为 $ax + by = c$（其中 $a,b,c$ 为常数，且 $a,b$ 不同时为 0）。二元一次方程组是由两个（或两个以上）二元一次方程组成，常见为 $$ \begin{cases} a_1x + b_1y = c_1\\ a_2x + b_2y = c_2 \end{cases} $$ 方程组应用建模就是把题目中的数量关系翻译成方程组，通过求解得到实际问题的答案。 (2) 性质定理：方程组的解必须同时满足方程组中的每一个方程，因此解是两个方程公共的 $(x,y)$。常用解法有代入消元法与加减消元法：代入消元法适合某个方程易表示成 $x = \dots$ 或 $y = \dots$；加减消元法适合两个方程中某个未知数的系数相同或相反，便于相加或相减消去一个未知数。建模时常用关系包括：总量关系（如“总数 = 部分之和”）、单价数量总价关系（“$总价 = 单价 \times 数量$”）、路程速度时间关系（$路程 = 速度 \times 时间$）等。 (3) 注意事项：设未知数要带单位与含义，例如“设甲买了 $x$ 支笔”；列方程要对应同一类量，别把“支数”和“元数”混在一条等式里；检查条件是否满足题意（如数量应为整数且 $> 0$）；消元后别忘了回代求另一个未知数；最后答案要写清对象与单位，并可把解代回原式检验。 ## 知识点应用 - 典型例题：文具店买笔和本子。小明买了 2 支笔和 3 本本子共花 19 元；小红买了 3 支笔和 2 本本子共花 18 元。求每支笔和每本本子的单价。 - 关键步骤： 1. 设未知数并写出含义：设每支笔单价为 $x$ 元，每本本子单价为 $y$ 元。 2. 根据题意列方程组：由“$总价 = 单价 \times 数量$”得 $$ \begin{cases} 2x + 3y = 19\\ 3x + 2y = 18 \end{cases} $$ 3. 选择消元并求解：用加减消元。将第一式乘 3、第二式乘 2： $$ \begin{cases} 6x + 9y = 57\\ 6x + 4y = 36 \end{cases} $$ 相减得 $5y = 21$，所以 $y = \dfrac{21}{5} = 4.2$。代入 $3x + 2y = 18$ 得 $3x + 8.4 = 18$，所以 $3x = 9.6$，$x = 3.2$。 - 结论：每支笔 3.2 元，每本本子 4.2 元（两者均 $> 0$，符合题意）。 MARKDOWN; } private function normalizeKpExplanation(string $content): string { $content = trim($content); if ($content === '') { return ''; } if ($this->looksLikeHtml($content)) { return $content; } if (! class_exists(\Michelf\MarkdownExtra::class)) { $safe = htmlspecialchars($content, ENT_QUOTES, 'UTF-8'); return '

'.nl2br($safe).'

'; } $parser = new \Michelf\MarkdownExtra; $markdown = html_entity_decode($content, ENT_QUOTES, 'UTF-8'); $rendered = $parser->transform($markdown); return '

'.$rendered.'

'; } private function looksLikeHtml(string $content): bool { if (stripos($content, 'kp-markdown-container') !== false || stripos($content, 'kp-markdown-content') !== false) { return true; } return (bool) preg_match('/<\s*(p|div|h[1-6]|ul|ol|li|table|span|blockquote|pre|code|br)\b/i', $content); } private function shouldUseDefaultExplanations(): bool { if (!Schema::hasTable('knowledge_points')) { return true; } return !Schema::hasColumn('knowledge_points', 'explanation'); } }